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Preface 


The MVS configuration program is to be used by installations that have installed 

MVS/System Product Version 2 Release 2.0 (MVS/SP2.2.0) or a later release. 

These installations use the MVS configuration program to: 

e Define new I/O configurations or eligible device tables 

e Replace existing I/O configurations or eligible device tables 

e Define the consoles that the nucleus initialization program (NIP) can use 

@ Migrate I/O configurations or eligible device tables that were previously 
defined through the SYSGEN process so they can be used on the 
MVS/SP2.2.0 or a subsequent release. 

This book explains how to use the MVS configuration program to do these tasks. 

{ Note: Although the MVS configuration program is not used to delete I/O 


configurations or eligible device tables, this book also explains how to do those 
tasks. 


Audience for This Book 


This book is intended for anyone who will use the MVS configuration program. 
Usually, this will be the installation’s systems programmers. 


Terminology 


At various places this book uses the acronym MVSCP to refer to the MVS 
configuration program. 


C 
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How This Book Is Organized 


This book is divided into the following chapters and appendixes: ww 


Chapter 1, “Introduction” on page 1-1 introduces the MVS configuration 
program and compares its processing to that of the SYSGEN process. First 
the chapter explains how the SYSGEN process created an I/O configuration. 
This is followed by an explanation of how the MVS configuration program 
creates an I/O configuration. This comparison will help first time users of the 
MVS configuration program understand the difference between the SYSGEN 
process and the MVS configuration program process. 


Finally, the chapter introduces the MVS configuration program external 
interfaces and explains the purpose of each. 


Chapter 2, “Concepts, Definitions, and Relationships” on page 2-1 is 
intended for anyone who is unfamiliar with I/O concepts and definitions. 
Terms such as device type and model number and concepts such as generic 
device types, esoteric device groups, and the device preference table are 
explained. 


Chapter 3, “Planning an I/O Configuration” on page 3-1 provides a checklist 
of items you should consider when you plan an I/O configuration. 


Chapter 4, “Managing I/O Configurations” on page 4-1 contains the 
step-by-step procedures that explain how to do the following major tasks: 


— Migrate an I/O configuration previously defined through the SYSGEN JD | 
process 


— Define a new I/O configuration 
— Update an I/O configuration 
— Delete an I/O configuration or an eligible device table 


This chapter also includes a decision table to help you select the correct 
procedure to use. 


Chapter 5, “MVS Configuration Program Input Statement Reference” on 
page 5-1 explains how to code the MVS configuration program input 
statements. These are the statements that define your I/O configuration. 


Chapter 6, “Defining I/O Devices” on page 6-1 explains, in detail, how to 
code an IODEVICE statement to define specific I/O devices. Each 
explanation identifies required parameters, optional parameters, and device 
features that you can specify. 


Chapter 7, “Defining Eligible Device Tables and NIP Consoles” on page 7-1 
provides detailed instructions for defining an eligible device table and for 
identifying the consoles that NIP will be allowed to use. 
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Chapter 8, “I/O Configuration Management Tasks” on page 8-1 describes 
how to do the subtasks that you must do as part of the major tasks that are 
described in Chapter 4, “Managing I/O Configurations.” 


Chapter 9, “Reading MVS Configuration Program Reports” on page 9-1 
explains how to read the MVS configuration program reports. 


Chapter 10, “Debugging, Messages, and Codes” on page 10-1 explains what 
to do in case of an error. Included 1s: 


— An explanation of the output you will receive if there is an input stream 
error and an explanation of the output you will receive if there is a logic 
error in the MVS configuration program 


— Instructions on how to read the MVS configuration program messages 
— The MVS configuration program messages and reason codes 


Appendix A, “Generic Device Types” on page A-1 lists the IBM-provided 
generic device types. 


Appendix B, “IBM Provided Device Preference Table” on page B-1 
identifies the device order that is defined by the IBM-provided device 
preference table. 


Appendix C, “Determining 3350P and 3351P Device Number Assignments” 
on page C-1! explains how to calculate the value of the device numbers that 
the MVS configuration program automatically assigns to the 3350P and the 
3351P devices. 


Appendix D, “MVS Configuration Program Example” on page D-1 contains 
an example of an MVS configuration program input stream. 


Appendix E, “Eligible Device Table Verification Service” on page E-1 
explains how to use program IEFEB400 to validate an eligible device table 
(EDT). 


How to Use This Book 


If this is the first time you have used this book: 


Read Chapter 1, “Introduction” on page 1-1. 


If you are unfamiliar with I/O concepts and definitions, read 
Chapter 2, “Concepts, Definitions, and Relationships” on page 2-1. 


Read Chapter 3, “Planning an I/O Configuration” on page 3-1. 


Read Chapter 4, “Managing I/O Configurations” on page 4-1 up to and 
including “Selecting the Correct Procedure” on page 4-3. 


You should also read the introductory section of each chapter. This will help you 
become familiar with where information is in the book. 


Preface V 





Once you are familiar with the book and are ready to use the MVS configuration 
program, turn to the decision table in “Selecting the Correct Procedure” on 

page 4-3. That table will help you select the correct procedure for the task that 
you wish to do. 


After you have selected the procedure, look it over to become familiar with it. To 
do the procedure, start with step 1 and follow the procedure step-by-step. If there 
is a step that you do not need to do, go to the next sequential step. Ifa step 
contains insufficient information for you to do the step, read the material 
referenced by the step. 


If you have problems understanding the format or the organization of the input 
stream, look at the example in Appendix D, “MVS Configuration Program 
Example” on page D-1. This example might provide you with the information 
that you need to proceed. 


If the MVS configuration program issues error messages or abnormally 
terminates, follow the instructions given in the message documentation found in 
Chapter 10, “Debugging, Messages, and Codes” on page 10-1. 


Other Publications You Might Need 


V1 


At various places within the text, this book refers to the following IBM 
publications. 


e Assembler H Version 2 Application Programmer's Guide, SC26-4036 


@ Assembler H Version 2 Application Programmer's Language Reference, 
GC26-4037 


@ Input/Output Configuration Program User's Guide and Reference, GC28-1027 
e Introduction to the IBM 3250 Graphics Display System, GA33-3035 

@ MVS/Extended Architecture Data Administration: Utilities, GC26-4018 

e MVS/Extended Architecture Installation: System Generation, GC26-4148 

e MVS/Extended Architecture JCL, GC28-1148 

e MVS/Extended Architecture Message Library: System Codes, GC28-1157 


e MVS/Extended Architecture System Messages Volume 1 ADY - IEB, 
GC28-1376 


e MVS/Extended Architecture System Messages Volume 2 IEC - ISG, 
GC28-1377 


e MVS/Extended Architecture MVS Configuration Program: Diagnostic Guide, 
LY 28-1640 


e MVS/Extended Architecture Operations: System Commands, GC28-1206 
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e MVS/Extended Architecture System Programming Library: Initialization and 
a Tuning, GC28-1149 


e MVS/Extended Architecture: System Programming Library: JES3 Initialization 
and Tuning, SC23-0059 


@ MVS/Extended Architecture System Programming Library: System 
Modifications, GC28-1152 


e OS/VS Graphic Programming Support (GPS) for LBM 2250 Display Unit and 
IBM 3250 Graphics Display System, GC27-6971 


e@ OS/VS Mass Storage Control Table Create, GC35-0013 


e OS/VS Mass Storage System (MSS) Installation Planning and Table Create, 
GC35-0028 


@ OS/VS Message Library: VS2 System Codes, GC28-1008 


@ 3350/3344 Installation and Conversion Guide, GC20-1780 


Do You Have Problems, Comments, or Suggestions Related to This 
Book? 


r Your suggestions and ideas can contribute to the quality and the usability of this 
S book. If you have problems using this book or suggestions for improving it, 
complete and mail the Reader’s Comment Form found at the back of the book. 
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Chapter 1. Introduction 


Before MVS/System Product Version 2 Release 2.0 (MVS/SP2.2.0), installations 
used the SYSGEN process to define I/O configurations to MVS. When this book 
refers to defining an I/O configuration to MVS, it means: 


e Identifying the available I/O devices. 
e Defining esoteric device groups and naming each group. 


e Defining eligible device tables (EDTs) and assigning esoteric device groups to 
these tables. 


e Identifying devices that were eligible for virtual I/O (VIO). 
e Defining changes to the IBM-supplied device preference table. 


Installations that install MVS/SP2.2.0 or subsequent releases, will use the MVS 
Configuration Program to perform these functions. In addition, these 
installations will also use the MVS configuration program to: 


e Identify I/O devices that the Nucleus Initialization Program (NIP) may use as 
consoles. 


@e Request I/O configuration data for the JES3 initialization stream checker. 
This data will help JES3 identify inconsistencies between the MVS 
configuration definition and the JES3 configuration definition. 


Locating Information in this Chapter 


This chapter is intended only to give you an overview look at the MVS 
configuration program and to introduce MVS configuration program terminology. 
It is not intended to provide the detailed information that you need to use the 
MVS configuration program. That is the job of the other chapters. 


This chapter contains the following introductory topics: 


SYSGEN Overview 1-2 
Multiple 1/O Configurations 1-2 
MVS Configuration Program Overview 1-3 
Data Set Descriptions 1-5 
MVS Configuration Program Characteristics and Interfaces 1-6 
Multiple I/O Configuration Support 1-11 
JES3 Initialization Stream Checker Data 1-12 
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SYSGEN Overview 


During a SYSGEN, input statements describe the I/O configuration. Collectively J 
these statements are called the J/O configuration definition. The SYSGEN process 

uses the I/O configuration definition as input to create the control blocks that 

provide MVS with an internal representation of the I/O configuration. These 

control blocks are called the MVS I/O configuration data. 


The SYSGEN process combines the MVS I/O configuration data with the MVS 
nucleus to form a member (IEANUCOx) of the SYSI.NUCLEUS data set. The 
system loads this member, and the member becomes the MVS nucleus. 


Multiple I/O Configurations 


When an installation defines multiple I/O configurations, the SYSGEN process 
combines the MVS I/O configuration data for each configuration with a separate 
but identical copy of the MVS nucleus. Combining the MVS I/O configuration 
data with the nucleus creates a separate IEANUCOx member for each I/O 
configuration. At IPL, the operator specifies which IEANUCO0x member is to be 
used as the MVS nucleus. In this way the operator selects a specific I/O 
configuration. 


Figure 1-1] shows how SYSGEN supports multiple I/O configurations; shown as 
I/O configurations one, two, and three, with separate copies of the MVS nucleus 
to form three IEANUCOx load modules. 


IEANUCO1 IEANUC02 IEANUC03 , ; 


MVS nucleus MVS nucleus MVS nucleus 


configuration configuration 
one two 


configuration 
three 





Figure 1-1. Multiple I/O Configuration Support before MVS/SP2.2.0 


The way that SYSGEN supports multiple I/O configurations requires, for each 
configuration, a separate copy of the MVS nucleus. This method of support 
causes extra maintenance: user modifications that are applied to the nucleus have 
to be applied to each copy of the nucleus. The same is also true of IBM-provided 
modifications. In addition, each time an installation changes an existing I/O 
configuration, it might have to reapply any modifications previously made to the 
related copy of the nucleus. 
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MVS Configuration Program Overview 


a The MVS configuration program replaces the I/O definition functions IOGEN 
and EDTGEN) previously available through SYSGEN. The MVS configuration 
program, in combination with other program enhancements, enables one copy of 
the MVS nucleus to support multiple I/O configurations. Also, with the MVS 
configuration program, modifications to the nucleus do not have to be reapplied 
after an installation updates an existing I/O configuration. 


Note: In addition to defining each I/O configuration to MVS, you or another 
systems programmer must also use the I/O configuration program (IOCP) 
to define the configuration to the channel subsystem. You can use the same 
input stream to define the configuration to both the MVS configuration 
program and IOCP. For information on how to use the IOCP, see the 
Input/Output Configuration Program User's Guide and Reference. 


Figure 1-2 on page 1-4 shows the data sets and data flow for the I/O definition 
process. The figure shows inputs to the process and outputs that the process 
produces. Following the figure is a brief description of each major data set used 
in the process. 


Although the figure shows the MVS configuration program and the IOCP running 
at the same time, you can actually run these programs at separate times 
independent of each other. They are shown together only to remind you that they 
share a common input stream. 


Chapter 1. Introduction 1-3 


I/O DEFINITION PROCESS 





MVS DEFINITION 


CATALOGED PROCEDURE I/O CONFIGURATION DATA 


MACRO DEFINITIONS 


Ce MVS CONFIGURATION PROGRAM 
PROCESSING 


1/0 CONFIGURATION DEFINITION 


CHANNEL SUBSYSTEM DEFINITION J 
IOCP 
IOCDS 
PROCESSING 


Figure 1-2. MVS and Channel Subsystem I/O Definition Process 
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Data Set Descriptions 


The data sets shown in the previous figure are described below. In the 
description, DSN and DD Name correspond to the data set name and the DD 
name, respectively, specified in either the IBM-provided catalog procedure or the 
IBM-provided sample JCL statements. The catalog procedure and the sample 
JCL are shown in “Using the Cataloged Procedure or the SAMPLIB JCL” on 
page 8-3. 


(1) Invocation JCL SYS1.PROCLIB none 
The cataloged procedure in SYS1.PROCLIB or the SYS1.SAMPLIB 

sample JCL in SYS1.SAMPLIB used to invoke the 

MVS configuration program. 

(2) Macro definitions SYS1.MACLIB SYSLIB 
Assembler macro definitions that the Assembler uses to 

parse MVS configuration program input statements. 

(3) I/O configuration definition Not applicable SYSIN 
The MVS configuration program input statements and 

the IOCP input statements that describe an I/O 

configuration. You code these statements. 


(4) 1/O configuration data SYSI.NUCLEUS | SYSLMOD 
A partitioned data set (PDS) that contains the I/O 
configuration that the MVS configuration program 
creates. The MVS configuration program stores this 
data into members, IEANCTxx, IEFEDTxx, IOSIITxx, 
and IOSUCBxx. 
Note: The value xx appended to the member names is 
an identifier that you define. It distinguishes one 
configuration from another. The identifier’s use 
is explained in more detail later in the topic 
“Output Identifiers” on page I-10. 
(5) Reports Not applicable SYSRPT 
MVS configuration program reports: 
@ I/O supervisor (IOS) report 
contains an entry for each device defined in the 
configuration 
Allocation report 
contains eligible device table information 
NIP report 
lists the devices that NIP can use as consoles 
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(6) Messages Not applicable assembler messages: 
SYSASMP 

Messages that were issued during the I/O definition 

process. loader messages: 
SYSLOUT 


linkage editor 
messages: 
SYSLKEDP 


MVSCP messages: 
SYSPRINT 


(7) JES3 Output Not applicable SYSJES3 


Data that the MVS configuration program produced 
for the JES3 initialization stream checker. 


(8) IOCP reports Not applicable Not applicable 


IOCP reports. 


(9) IOCDS - The I/O configuration data for the Not applicable Not applicable 
channel subsystem 


For a functional description of all of the files used by the MVS configuration 
program, see “Standard DD Name List” on page 8-18. 





Note: The MVS configuration program resides in SYS1.LINKLIB. 


The remainder of this chapter provides an overview of the MVS configuration 
program and how you use it to define an I/O configuration to MVS. 


MVS Configuration Program Characteristics and Interfaces 


The MVS configuration program runs as a problem program on either MVS/370 
or MVS/XA. Each time you run the MVS configuration program, you can define 
only one I/O configuration. You can, however, define multiple eligible device 
tables. If you need to define more than one I/O configuration you must run the 
MVS configuration program once for each configuration. 


Although the MVS configuration program runs on MVS/370 or on MVS/XA, you 
can use the I/O configurations that it builds on MVS/SP2.2.0 or a subsequent 
release only. 


MVS Configuration Program Input Statements 


You code input statements to describe an I/O configuration to the MVS 
configuration program. The MVS configuration program and the IOCP can 
share a common input stream that contains both MVS configuration program 
input statements and IOCP input statements. Collectively, these statements are 
called the I/O configuration definition. 
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The MVS configuration program accepts, as SYSGEN did, the following input 
statements: 


CHPID 
CNTLUNIT 
ID 
IODEVICE 
UNITNAME 


In addition, the MVS configuration program accepts three new input statements: 


e IOCONFIG 
e EDT 
e NIPCON 


The eight statements listed above are the only input statements that should appear 
in the input stream. 


The following table summarizes the purpose of each statement and identifies 
which program, the MVS configuration program or IOCP, uses the statements: 


Used by 
CHPID IOCP Define channel paths. 
CNTLUNIT_[10CP 


EDT MVS configuration program | Define an eligible device table, assign it an identifier, 
and define changes to the device preference table. 


IOCP Define data that is to appear in the headings of IOCP 
reports and in the headings of MVS configuration 
MVS configuration program | program reports. 


IOCONFIG MVS configuration program | Assign an identifier to an I/O configuration. 


IODEVICE IOCP Define an I/O device. 


MVS configuration program 


NIPCON MVS configuration program | Identify devices that NIP will be allowed to use as 
consoles. 


UNITNAME | MVS configuration program Define and name an esoteric device group and 
indicate whether it is eligible for virtual 
input/output (VIO). 

Identify generic device types that you want to make 
eligible for virtual I/O (VIO). 





Figure 1-3. Input Statement Summary 


For a detailed description of the EDT, IOCONFIG, IODEVICE, NIPCON, or 
UNITNAME statements, see Chapter 5, “MVS Configuration Program Input 
Statement Reference” on page 5-1. For a detailed description of the CHPID, 
CNTLUNIT, or ID statements, see the Input/Output Configuration Program 
User's Guide and Reference. 
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IBM-Provided Cataloged Procedure and Sample JCL 


Devices Supported 


IBM provides both a cataloged procedure and sample JCL statements that you S 
can use to invoke the MVS configuration program. The cataloged procedure is in 
SYS1.PROCLIB(MVSCP); the sample JCL is in SYS1.SAMPLIB(MVSCPXA) 

and SYS1.SAMPLIB(MVSCP370). Which one you use depends on the MVS 

release level on which you run the MVS configuration program and the MVS 

release level on which you intend to use the I/O configuration. For information 

about using the cataloged procedure or the SAMPLIB JCL, see “Using the 

Cataloged Procedure or the SAMPLIB JCL” on page 8-3. 


The MVS configuration program supports many IBM-built devices and several 
non-IBM devices. For a list of the supported devices, look in the index for the 
specific device type (for example, 3330 or 3380), or look in the index under the 
entry devices supported. 


Note: The MVS configuration program supports all of the devices that the 
MVS/XA SYSGEN process supported except the 2260. 


For each device type that it supports, the MVS configuration program provides a 
program called a unit information module (UIM). The UIMs process the 
IODEVICE statements and provide device-dependent data. 


If you have a device that the MVS configuration program does not support, you 
can still use that device. To make such a device available for use, you must either 
define it asa DUMMY device or provide a UIM to support it. ) 


For more information about defining an unsupported device, see “Defining an 
Unsupported Device” on page 6-4. For details about coding a UIM, see 
MVS/Extended Architecture System Programming Library: System Modifications. 


MVS Configuration Program Modes of Operation 


The MVS configuration program has four modes of operation: IODEF, EDT, 
VALIDATE, and DEBUG. After you select a mode and invoke the MVS 
configuration program, the MVS configuration program processes the input 
statements according to the mode selected. During processing, the MVS 
configuration program invokes the Assembler, the loader, and the linkage editor. 


The following table explains the purpose of each MVS configuration program 
mode. 
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Purpose and MVS Configuration Program Action 


IODEF Used to create a new configuration or to update an existing configuration. 

e For a new configuration, the MVS configuration program writes new configuration 
members 
For an existing configuration, the MVS configuration program replaces all members 
of the configuration. 
Optionally, the MVS configuration program writes I/O configuration related data 
for use by JES3. 
The MVS configuration program also writes the IOS report, the allocation summary 
report, and the NIP report. 

IODEF mode is functionally similar to a SYSGEN IOGEN. 

EDT Used to replace an existing eligible device table (EDT) or to create a new EDT for an 

existing configuration. 

e If you update an EDT, the MVS configuration program replaces the updated 
member of the configuration. 
If you create a new EDT, the MVS configuration program writes a new member for 
the configuration. 
Optionally, the MVS configuration program writes I/O configuration related data 
for use by JES3. 
The MVS configuration program also writes the IOS report, the allocation summary 

L_ report, and the NIP report. 
EDT mode is functionally similar to an EDTGEN. 


VALIDATE | Used to validity check MVS configuration program input statements without creating or 
| replacing a configuration. 
e The MVS configuration program writes error messages for each error it finds on an 
input statement. 
e The MVS configuration program also writes the IOS report, the allocation summary 
report, and the NIP report. 
Note: The MVS configuration program also validity checks input statements in both 


IODEF and EDT modes. 








Figure 1-4 (Part 1 of 2). Overview of the Modes of Operation 
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Purpose and MVS Configuration Program Action 


Used to produce additional output when you suspect a problem with the MVS 
configuration program. 


e The MVS configuration program validity checks the input statements and builds the 
configuration but does not write it to the output data set. 


The MVS configuration program prints the Assembler text records and the loader 
output. 


The MVS configuration program also writes the IOS report, the full set of allocation 
reports, and the NIP report. 





Figure 1-4 (Part 2 of 2). Overview of the Modes of Operation 


For a more detailed explanation of when to use each mode, see “Selecting the 
Mode of Operation” on page 8-14. 


MVS Configuration Program Output 


The MVS configuration program output depends on the mode that you select and 
whether there are errors in the input statements. Detectable errors in the input 
statements cause the MVS configuration program to issue messages and, 
depending on the severity of the error, can prevent the MVS configuration 
program from writing the I/O configuration data. 


I/O Configuration Members: When the MVS configuration program writes I/O 
configuration data, it writes it to members of a partitioned data set (PDS). The 
members are named IEANCTxx, IEFEDTxx, IOSIITxx, and IOSUCBxx. 


The number of members written depends on the number of eligible device tables 
defined in the I/O configuration definition. For each I/O configuration, the MVS 
configuration program writes one each of the following: IEANCTxx, IOSIITxx, 
and IOSUCBxx. In addition, the MVS configuration program writes one 
IEFEDTxx member for each eligible device table. Unlike SYSGEN, the MVS 
configuration program does not combine the I/O configuration data with the MVS 
nucleus. 


In addition to writing I/O configuration data, the MVS configuration program 
writes messages, reports, and, optionally, data that can be read by the JES3 


initialization stream checker. 


Output Identifiers: The value xx appended to member names is the identifier that 
you assign. 


e For the IEFEDTxx members, it is one of the following: 
— If you specify an identifier on the EDT statement, it is that identifier. 


— If you omit the identifier or omit the EDT statement, it is the identifier 
on the IOCONFIG statement. 


e For the other members, it is the identifier specified on the IOCONFIG 
statement. 
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These identifiers enable MVS and the operator to distinguish one I/O 
configuration from another and one eligible device table from another. 


Output Data Set: Before MVS can use the I/O configuration data, the data must 
be stored in the SYSI1.NUCLEUS data set. Two suggested ways to store the data 
are: 


e Allocate the SYS1.NUCLEUS data set as the MVS configuration program 
output data set. The MVS configuration program will then write the 
members to the SYSI.NUCLEUS data set. 


e Allocate some other PDS as the MVS configuration program output data set. 
After the MVS configuration program executes, you can use a utility program 
to copy the members to the SYS1.NUCLEUS data set. 


Multiple I/O Configuration Support 


Through the MVS configuration program, you can define multiple I/O 
configurations, and within each configuration, multiple eligible device tables. 
During the IPL process, the operator selects the nucleus, the I/O configuration, 
and the eligible device table that are to be used. The operator can make the 
selections explicitly (by specifying the appropriate identifiers) or implicitly by 
allowing the selections to default. 


The default nucleus is IEANUCO1. The default I/O configuration is the 
configuration that has the identifier 00. The default eligible device table is the 
table that has the same identifier as the selected I/O configuration. 


MVS uses the selected nucleus, the selected I/O configuration, and the selected 
eligible device table until the next IPL. If, after selecting an I/O configuration 
and EDT, the operator wants to make a different selection, the operator must 
re-IPL MVS. For detailed information about how the operator makes these 

~ selections, See MVS/Extended Architecture Operations: System Commands. 


The following example and Figure 1-5 on page 1-12 shows how the MVS/System 
Product supports multiple I/O configurations with one copy of the MVS nucleus. 


e The configuration with an identifier of 00 contains one eligible device table 
which also has an identifier of 00. The data for this I/O configuration 
consists of members IEANCT00, IOSIITO0, IOSUCBO00, and IEFEDTO0. 


e The configuration with an identifier of AA contains three eligible device 
tables with identifiers of 10, 11, and 12. The data for this I/O configuration 
consists of members IEANCTAA, IOSIITAA, IOSUCBAA, IEFEDT10, 
IEFEDT11, and IEFEDT12. 
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If, for example, the operator selects I/O configuration AA, eligible device table 11, 

and allows the nucleus selection to default, the system loads members 

IEANUCO1, IEANCTAA, IOSIITAA, IOSUCBAA, and IEFEDT11. MVS then 2 
uses that nucleus, that I/O configuration, and that eligible device table until the 





next IPL. 
MVS 
nucleus 
IEANUCO1 
configuration 00 configuration AA 


IEANCTO0 IEANCTAA 


IEFEDTO00 


JEFEDT12 





Figure 1-5. MVS/SP Version 2 Multiple I/O Configuration Support 


JES3 Initialization Stream Checker Data 





During the JES3 initialization process, the JES3 systems programmer must define il 
the I/O configuration to JES3. It is essential that the JES3 definition and the 
MVS configuration program definition be consistent. 


Each time you run the MVS configuration program in either IODEF mode or 
EDT mode, you can request that it create configuration data for JES3. This data, 
when read by the JES3 initialization stream checker, permits JES3 to detect 
inconsistencies between its I/O definition and the MVS configuration program’s 
I/O definition. 


You can use the MVS configuration program to create data for the JES3 
initialization stream checker regardless of the JES3 release level on which it will 


be used. 


For more information about how JES3 uses this data, see MV S/Extended 
Architecture: System Programming Library: JES3 Initialization and Tuning. 
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Chapter 2. Concepts, Definitions, and Relationships 


This chapter is intended primarily for those who are unfamiliar with I/O concepts 
and definitions. There are several definitions and concepts that you need to 
understand when reading the rest of this book. This chapter explains those 
definitions and concepts. 


Locating Information in this Chapter 


This chapter contains the following major topics: 


I/O Device, UCB Relationship 2-1 
I/O Device Terminology 2-2 
Device Type 2-2 
Model Number 2-2 
Device Class 2-2 
Multiple Exposure Device 2-2 
Generic Device Types 2-3 
Esoteric Device Groups and EDTs 2-4 
What is an Esoteric Device Group? 2-4 
What is the Device Preference Table? 2-5 
What is an Eligible Device Table (EDT)? 2-6 
What is a Virtual I/O (VIO) Eligible Device? 2-7 
What is the NIP Console Table? 2-7 


I/O Device, UCB Relationship 


The UCB is the MVS internal representation of an I/O device. The MVS 
configuration program creates one UCB for each device number indicated on an 
IODEVICE statement. 


oy 
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I/O Device Terminology 





This book uses the following terminology when discussing I/O devices. 


Device Type 


Each IBM-built I/O device has a type and, in some cases, a model number. The 
designers of the device determine the device type and model number. 


Device type refers to the 4-digit number by which the device is known. For 
example: 


1403 
2305 
3330 


Model Number 


The model number, or model, refers to a specific variation of a device type. 
Model is represented by a dashed number, letter, or both following the device 
type. For example: 


2305-2 
3278-1 
3330-1 


Device Class | | ; 


MVS groups devices into one of the following device classes: 


Channel-to-channel adapters 
Communication devices 
Direct Access Devices 
Display devices 

Character Readers 

Magnetic Tape Devices 
Unit Record devices 


For a list of the devices types that are included in each device class, see 
Appendix A, “Generic Device Types” on page A-l. 


Multiple Exposure Device 
This book refers to a device that can be: 


e Allocated by a single device number only 
@ Accessed by multiple device numbers 


as a multiple exposure device. Each device number represents one exposure. The 
device number by which the device is allocated is called the base exposure The 
other device numbers are called non-base exposures. 
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For some devices each exposure corresponds to a separate device access 
mechanism. An example of such a device is the 2305 model 2. For other devices 
that are attached to a control unit that has a cache, each exposure corresponds to 
a separate logical path to a single access mechanism. Examples of such devices 
are the 3350P and 3351P. 


For a multiple exposure device, the MVS configuration program generates 
multiple device numbers. You provide the initial device number and a value 
called the replication factor (the replication factor is also called number-of-units). 
The MVS configuration program builds a UCB for each exposure. 


The total number of device numbers that the MVS configuration program 
generates for a particular device depends on two factors: 


@ The device type 
@ The value of the replication factor 


The values of the generated device numbers also depends on two factors: 


e The device type 
e@ The value of the device number that you provide 


The multiple exposure devices that the MVS configuration program supports are: 


@ 2305-2 
@ 3350 attached to a 3880-11 (called a 3350P) 
e@e 3350 attached to a 3880-21 (called a 3351P) 


Generic Device Types 


MVS logically groups device types with similar characteristics and assigns the 
group a generic name. Such a group is called a generic device type. When you 
refer to a generic device type, you refer to it by its generic name. 


MVS, for example, groups the 3330-1, the 3330-2, and the 3333-1 into a generic 
device type named 3330. Anytime a program refers to a 3330, MVS interprets it 
to mean any of the devices in that generic device type. 


To request a device allocation, a user can specify a generic device type rather than 
a specific device number. MVS then allocates a device from the specified generic 


device type. 


For example, if a user coded the following DD statement: 

/{OUTPUT DD UNIT = 3330... 

MVS would allocate a device from the generic device type named 3330. 

Generic device types, permit a user to request an I/O device without specifying a 


specific device number. For a list of generic names and the device types that 
correspond to that name, see Appendix A, “Generic Device Types” on page A-l. 
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Esoteric Device Groups and EDTs 


Each time a user submits a job, UNIT = parameters on DD statements or the 2 
corresponding dynamic allocation parameters, identify the I/O devices the job 

requires. Before the job can continue execution, MVS must allocate all of those 

devices to the job. 


If the user requests a specific device (specifies a device number on the UNIT= 
parameter or on the corresponding dynamic allocation parameter), and that 
device is available, MVS allocates the device to the job. If the device is 
unavailable, however (it’s allocated to another job, for example), the user’s job 
will have to wait until the device becomes available for allocation. By requesting 
a specific device, the user has limited the choice of devices to one. By limiting the 
choice of devices, the user increases the probability that the device the job needs 
will be unavailable when needed. 


The user can increase the probability that a device will be available for allocation 
when needed by requesting a generic device type. The increase in probability 
assumes, of course, that there is more than one device of that generic type 
available to be allocated. 


When a user requests a generic device type, MVS “serializes” on that generic 
device type. This means that MVS does not allocate devices from that generic 
device type to other jobs until the user’s job allocation request is satisfied. 
Because MVS makes the entire generic device type unavailable for allocation to 
other jobs, there might be a delay in satisfying the other job’s allocation requests. 
Thus, when a user requests a generic device type, it increases the probability that ~ 
there will be a delay in satisfying allocation requests for other jobs. 





Esoteric device groups, eligible device tables (EDTs), and the device preference 
table provide a means for you to manage these potential allocation performance 
problems. 


What is an Esoteric Device Group? 


An esoteric device group is an installation-defined and named collection of I/O 
devices. When a user submits a job, the job can identify a device that it needs by 
specifying an esoteric device group instead of a specific device number or a 
generic device type. A job that specifies an esoteric device group is requesting 
MVS to allocate a device from that group. 


When MVS allocates devices to that job, MVS will “serialize” on the esoteric 
device group until the allocation request is satisfied. Only those devices that 
belong to the esoteric device group will be unavailable for allocation to other 
jobs. 


Assuming that the esoteric device group identifies more than one device, a device 
will more likely be available when requested than if the request was for a specific 
device. Also, if you assume that the esoteric device group does not contain all of 
the devices from any one generic device type, devices from each generic device 
type might still be available for allocation to other jobs during the time that MVS 
is “serialized” on the esoteric device group. 
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You use the MVS configuration program to define a group, assign it a name, and 
to identify the I/O devices that you want included in the group. The name you 
assign to an esoteric device group Is called the esoteric name or, in JCL 
terminology, the user-assigned-group-name. To request allocation of a device 
from an esoteric device group, a user specifies the esoteric name on the UNIT = 
parameter of a JCL DD statement. 


An esoteric device group can include devices ‘of different generic device types. 
With one exception, however, you should not define a group that includes devices 
from more than one device class. For example, a group that includes unit record 
devices must include only unit record devices. The exception: You can define one 
or more groups that contain both DASD and magnetic tape devices. 


What is the Device Preference Table? 


An esoteric device group can include devices of more than one generic device 
type. When MVS attempts to allocate a device from an esoteric device group, 
MVS needs to be told in what order to attempt the allocation. The device 
preference table defines that order. 


IBM provides a predefined device preference table. The table that IBM provides 
is defined such that MVS attempts to allocate the fastest device available to each 
allocation request. For each EDT that you define, you can setup the device 
preference table in any order you prefer. 


For example, assume you have defined an esoteric device group that includes only 
generic device types 2305-2, 3330, and 3380. Also assume that you have not 
changed the order of the device preference table. When MVS attempts to allocate 
a device from this group, the device preference table tells MVS to attempt 
allocation in the following order: 2305-2, 3380, and 3330. 


The IBM-provided device preference table is shown in Appendix B, “IBM 
Provided Device Preference Table” on page B-1. 


Device Preference Table’s Affect on UNIT = AFF Request 


When a job requests unit affinity, the sequence of device types as they appear in 
the device preference table can affect allocation. The sequence affects allocation 
whenever a DD requests unit affinity to another DD that has requested allocation 
to an esoteric device group and both DDs specify a status of NEW. When this 
situation occurs, MVS allocates both DDs to the same physical unit. That unit: 


e Will belong to the specified esoteric device group 


@ Will be the first device type from that esoteric device group to appear in the 
device preference table 
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The following example shows how the device preference table affects a 
UNIT =AFF specification. } 


Example 


Conditions 


e Your installation has previously defined an esoteric device group and 
named it TAPE. Device types 3400-3, 3400-5, and 3480 belong to the 
group named TAPE. 


Your installation is using the IBM-provided device preference table. In 
that table affected device types appear in the following order: 


3480 
3400-5 
3400-3 


e Assume the following JCL statements: 


//JOB! JOB 

//STEP1 EXEC 

/[DD!1 DD DISP=NEW,UNIT=TAPE, 
/[DD2 DD DISP=NEW,UNIT=AFF=DDIl, 


/| 


Explanation 


DD1 requests MVS to allocate a device from the esoteric device group ! 
TAPE. ? y 


DD2 requests affinity to DD1. 


MVS allocates DD1 and DD2 to the same physical unit. That unit will 
be a 3480. 





What is an Eligible Device Table (EDT)? 


An EDT is an installation-defined and named representation of the devices that 
are eligible for allocation. The EDT also defines the esoteric and generic 
relationships of these devices. 


During each IPL, the installation identifies the EDT that MVS is to use. Jobs 
that execute after the IPL can request device allocations from any of the esoteric 
device groups assigned to the selected EDT. 


You use the MVS configuration program to define EDTs, name the EDTs (the 
name is actually a two-character identifier), and identify the esoteric device groups 
that each EDT is to define. For each I/O configuration you must define at least 
one EDT. 
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What is a Virtual I/O (VIO) Eligible Device? 


VIO refers to data set allocations that exist in paging storage only. A real device 
is not used unless the data set must be paged out. If the data set must be paged 
out, MVS writes it to a paging device. Programs that use VIO data sets access 
them just as if the data sets were allocated to a real I/O device. 


Users can allocate only temporary data sets to VIO. To request a VIO allocation, 
the UNIT = parameter on the user’s DD statement must specify an esoteric 
device group or generic device type that is eligible for VIO. The book 
MVS/Extended Architecture JCL explains, in detail, how to make the request. 
That book also explains the conditions that must be met before MVS satisfies a 
VIO allocation request. 


You use the MVS configuration program to identify the esoteric device groups or 
the generic device types that you want to be eligible for VIO allocation. MVS 
will allocate only DASD for VIO. Therefore, any group that you identify must 
contain at least one DASD. 


What is the NIP Console Table? 


The NIP console table identifies, to MVS, the devices that you will allow NIP to 
use as consoles. You identify these devices to the MVS configuration program by 
coding one or more NIPCON statements. You must do this for each I/O 
configuration that you migrate and for each new configuration that you define. 
MVS attempts to use the devices in the same order that you define them. For 
more detailed information about defining the NIP console table, see “Defining 
NIP Consoles” on page 7-9. 
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Chapter 3. Planning an I/O Configuration 


Before you can use the MVS configuration program to define an I/O 
configuration, you must first plan that configuration. The planning activities 
include the following: 


Identify the I/O devices that you will include in the configuration. 

Decide how many esoteric device groups to define, identify the I/O devices 
that you will include in each group, select a name for each group, and identify 
those groups you want to make eligible for VIO. 

Identify any generic device types that you want to make eligible for VIO. 
Decide how many eligible device tables (EDTs) to define, identify the esoteric 
device groups that you will include in each EDT, and select an identifier for 


each EDT. 


Define any changes you wish to make to the device preference table for each 
EDT. 


Identify the I/O devices that you will allow MVS to use as NIP consoles. 


When you complete the planning step, your plan should contain, at a minimum, 
the following information: 


Identifier for the I/O Configuration 

For each I/O device 

— Device type and model number (where applicable) 

— Type and model number of the control unit to which each device attaches 
— List of device features, if any 

— Device number you want assigned to device 

For each esoteric device group 

— List of devices you will assign to the group 


— Name you will assign to group 
— Whether the group is eligible for VIO 
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e For each EDT 


— ID you will assign 
— Names of esoteric device groups you will assign to EDT 
— Device preference table modifications, if any 


e For NIP consoles 
— List of devices that you want eligible for use as NIP consoles 


After completing the configuration plan, you are ready to define the I/O 
configuration. Defining the configuration means coding the configuration on 
input statements and executing the MVS configuration program and possibly the 
IOCP. When you finish, the internal representation of the I/O configuration will 
be available on data sets and will be ready for use by the system. 


I/O Configuration Planning Checklist 


The following checklist identifies planning decisions that you must make and 
provides references to information that will assist you in making the decisions. 
After you have made all of these planning decisions you will have a plan for an 
I/O configuration. Step-by-step procedures in Chapter 4, “Managing I/O 
Configurations” on page 4-1 will help you define the configuration that your plan 
describes. 
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Planning Activities 





Planning Decisions You Must Make 
Decide which I/O devices to include in None. 
the configuration. 
Determine if your configuration will “Determining if The MVS Configuration Program 
include any unsupported devices Supports a Device” on page 6-3. 
Decide how to support any “Defining an Unsupported Device” on page 6-4. 
unsupported devices. 
Determine if other required products “Other Products May be Required” on page 6-5. 
have been installed. 


Decide which esoteric device groups “Esoteric Device Groups and EDTs” on page 2-4. 
to define, and select a name for each 
group. 


















“What is an Esoteric Device Group?” on page 2-4. 






“Required Esoteric Device Groups” on page 7-5. 






Decide how many eligible device 
tables to define and select an identifier 
for each table. 


“Esoteric Device Groups and EDTs” on page 2-4. 
















“JES3 Initialization Stream Checker Data” on 
page 1-12 


Note: JES3 supports only the first 
EDT defined in an I/O 
configuration. Therefore, JES3 
installations should define no 
more than one EDT per I/O 

configuration. 

















Select the esoteric device groups and 
the generic device groups that you 
want to make eligible for VIO. 


“What is a Virtual I/O (VIO) Eligible Device?” on 
page 2-7 






Appendix A, “Generic Device Types” on page A-1 





Decide what changes, if any, you will 
make to the device preference table 
for each EDT. 


“What is the Device Preference Table?” on page 2-5. 






Appendix B, “IBM Provided Device Preference 
Table” on page B-1. 


Select devices that you will allow NIP “What is the NIP Console Table?” on page 2-7. 
to use as consoles. 
“Defining NIP Consoles” on page 7-9. 


Select an identifier for the “MVS Configuration Program Output” on page 1-10. 
configuration. 















“Assigning an I/O Configuration Identifier” on 
page 8-3. 

“JES3 Initialization Stream Checker Data” on 
page 1-12. 












Decide whether you want the MVS 
configuration program to create data 
that the JES3 initialization stream 

checker will use. 











Decide which data sets to use for: “Data Set Descriptions” on page 1-5. 












The input statements. 

@ The I/O configuration that will 
be built. 

@ The messages you will receive. 

@ The reports you will receive. 

@ The JES3 initialization stream 

data. 


Decide which MVS configuration 
program mode to use. The mode 
determines the type of output that 
you will receive. 












“Selecting the Mode of Operation” on page 8-14. 
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Overview of the I/O Configuration Management Process 


You should do the following activities only after you have completed your plan. J 
These activities are fully describes in the procedures found in 

Chapter 4, “Managing I/O Configurations” on page 4-1. They are mentioned 

here just to give you a complete picture of the I/O configuration planning and 

definition process. 


Code the input statements 

These statements, which contain information developed during the planning 
step, form the I/O configuration definition. They are input to both the MVS 
configuration program and IOCP. 


Modify the IBM-provided catalog procedure or the SAMPLIB JCL 
If you are going to use the IBM-provided catalog procedure or SAMPLIB 
JCL, make any required changes or overrides. 


Execute the MVS configuration program 
Defines the I/O configuration to MVS. 


Verify the I/O configuration 
Verify the I/O configuration by comparing the MVS configuration program 


reports to your plan. 


Execute the IOCP - Defines the I/O configuration to the channel subsystem. 
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During the MVS/System Product install process, you must define at least one I/O 
configuration to MVS and to the channel subsystem. If you intend to use an I/O 
configuration that was previously defined through the SYSGEN process, you may 
do so by migrating the I/O configuration. Otherwise, you will have to define a 
new I/O configuration. 


Migrating an I/O configuration means you use IODEVICE statements, 
UNITNAME statements and IOCP statements from the SYSGEN input stream. 
You merge these statements with other MVS configuration program statements, 
that you code, to create the MVS configuration program and IOCP input stream. 
You repeat this procedure for each I/O configuration you wish to migrate. 


After the MVS/System Product is installed and its I/O configurations defined, you 
must maintain those I/O configurations. Maintaining I/O configurations means, 
defining new I/O configurations, updating existing I/O configurations or eligible 
device tables, or deleting I/O configurations or eligible device tables. 


This chapter contains step-by-step procedures that explain how to: 


Migrate an I/O configuration previously defined through SYSGEN. 
Define a new I/O configuration. 

Update an existing I/O configuration. 

Delete an I/O configuration. 

Add, replace, or delete an eligible device table (EDT). 

Update the device preference table. 

Update the NIP console table. 


Locating Information in this Chapter 


This chapter contains the following major topics: 


Using the Procedures 4-2 

Selecting the Correct Procedure 4-3 
Migrating an I/O Configuration 4-4 
Updating an Existing I/O Configuration 4-12 
Defining a New I/O Configuration 4-19 
Deleting an I/O Configuration 4-26 

Deleting an Eligible Device Table (EDT) 4-28 
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Using the Procedures 


The first step in using any of the five procedures in this chapter is to determine J? 
which procedure to use. You can do this by using the decision table in “Selecting 
the Correct Procedure” on page 4-3. 


After you have determined the procedure to use: 


@ Familiarize yourself with the procedure by reading it through completely. 
Also, look over the information referenced by each procedure step. 


Each procedure starts with an explanation of what the procedure does. This 
is followed by: 


— An explanation of when to do the procedure. 
— A list of the inputs that must be available before you use the procedure. 
— A description of the output that the procedure produces. 


Finally, there is a step-by-step explanation of each activity that you must do 
to complete the procedure. These explanations are brief. Therefore, for most 
activities, there are references to other topics or books where you can find 
more detailed information. 


@ Once you are familiar with the procedure, start at step 1 and follow the 
procedure step-by-step. . 

e There may be some steps that you will not need to do. In these cases, go to “i 
the next step. 


e If you need to do a step but the procedure does not provide enough 
information, use the information referenced by the procedure step. 


Before attempting to IPL MVS/SP2.2.0, you must run the MVS 
configuration program in IODEF mode to build an I/O configuration 
that MVS/SP2.2.0 can use. To build this configuration use either of 
the following procedures: 


e “Migrating an I/O Configuration’ on page 4-4 
e “Defining a New I/O Configuration” on page 4-19 


The configuration must be available on the SYS1.NUCLEUS data set 
during the IPL. 





If the configuration is unavailable, the IPL will fail. 
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Selecting the Correct Procedure 


The following decision table will help you decide which procedure to use. The left 
column identifies different tasks that you will do; the right column identifies the 


procedure that explains how to do that task. 


To Perform This Task: Use This Procedure: 


Migrate an I/O configuration “Migrating an I/O Configuration” on page 4-4 


Use this procedure if you have an I/O 
configuration, previously defined through 
SYSGEN, that you wish to use. 


Define a new I/O configuration “Defining a New I/O Configuration” on 
Use this procedure to define a new I/O page 4-19 
configuration. 


Update an I/O configuration: “Updating an Existing I/O Configuration” on 
Use this procedure to update the following: page 4-12 


e I/O Device - Add a new device, delete a 
device, or change device information. 


EDT - Add a new EDT or update an 
existing EDT. 


Device preference table - Change the device 
allocation order. 


Esoteric device group - Add a new group, 
delete a group, or update a group. 


V1QO-eligible devices - Add a new group of 
devices, delete a group of devices, or update 
a group of devices. 


NIP console table - Add devices to or 
remove devices from the table that identifies 
the devices that NIP may use as consoles. 


Delete an I/O configuration “Deleting an I/O Configuration” on page 4-26 
Use this procedure to delete an I/O 
configuration that you no longer need. 


Delete an eligible device table “Deleting an Eligible Device Table (EDT)” on 
Use this procedure to delete an EDT that you page 4-28 
no longer need. 


Figure 4-1. Determining Which Procedure to Use 
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Migrating an I/O Configuration 


This procedure migrates an MVS/370 or MVS/XA I/O configuration that was 
previously defined through the SYSGEN process. You must repeat this 
procedure for each such I/O configuration you wish to migrate. 


Note: If you are unfamiliar with this procedure, read it through completely 


before using it. You should also review the detailed information referred to by 
each step. 





When to Do Procedure 


e Anytime you are migrating an I/O configuration from a system that uses the 
SYSGEN process to a system that uses the MVS configuration program. As 
an alternative to migrating an I/O configuration, you can define a new I/O 
configuration as explained in, “Defining a New I/O Configuration” on 
page 4-19. 


— The earliest you can do this procedure is after you have the input listed 
below. 


— The Program Directory indicates the /atest time in the install process that 
you can do this procedure. 


Procedure Input 


e The Program Directory for the MVS/System Product release that you are 
installing. 


e The SYSGEN input stream that previously defined the configuration. 

e The MVS configuration program, the IBM-provided cataloged procedure or 
the IBM-provided SAMPLIB member, and macro library (SYS1.MACLIB), 
must be available on the system where you intend to execute the MVS 
configuration program. 


e If you must execute IOCP (See step 23 of this procedure): 


— [OCP and its input libraries. 
— The publication JOCP User's Guide and Reference. 
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Procedure Output 


@e The MVS configuration program writes the internal representation of the I/O 
configuration to PDS members, IEANCTxx, IOSIITxx, IOSUCBxx, and 
IEFEDTxx. 


— The MVS configuration program writes one each of the following 
members: IEANCTxx, IOSIITxx, and IOSUCBxx. 


— The MVS configuration program writes one IEFEDTxx member for each 
eligible device table. 


— The MVS configuration program writes all of these members to the data 
set defined by the SYSLMOD DD statement. 


e If you execute IOCP, IOCP writes the channel subsystem’s internal 
representation of the I/O configuration to the IOCDS. 


@ Reports and messages. 


Procedure Activities 


[Step | Migrating an 1/0 Configuration 


Plan the migration: Chapter 3, “Planning 
an I/O Configuration” 

Review the current I/O configuration and define any desired on page 3-1 

changes. Document the changes in your configuration plan. 


Copy the existing SYSGEN input stream: 
Copy the input stream into a data set that you can edit. 


Use the program normally used to copy files at your installation. 
This step saves the SYSGEN input stream in case you need to refer 
to it later. 


Edit the copy of the SYSGEN input stream: “Using SYSGEN Input 
Statements to Migrate a 
(Use the editor normally used at your installation) Configuration” on 
page 8-1 
e Save statements -- ID, CHPID, CNTLUNIT, IODEVICE and 
UNITNAME. 


If you plan to use information from the DEVPREF parameter 
of the SCHEDULR statement, save the SCHEDULR 
statement. 

If desired, save comment statements. 


Delete all other statements including the END statement. 


Review your plan and delete any of the saved statements that 
you no longer need. 


The statements that remain form a base on which to develop the 
MVS configuration program input stream. 
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[Step _| Migrating an 1/0 Configuration 


Review recommended order of the MVS configuration program input | “Ordering Statements 
(5) 















stream: in the Input Stream” on 
page 8-13 










IOCONFIG 
ID 

CHPID 
CNTLUNIT 
IODEVICE 
EDT 
UNITNAME 
NIPCON 














Appendix D, “MVS 
Configuration Program 
Example” on page D-1 


Notes: 


I. EDT statements, if used, must immediately precede their related 
UNITNAME statements. 


Assembler comment statements may appear anywhere in the 
input stream. 





Do not include an END statement or any other statement not 
listed above in the input stream. 























Review input stream example: Appendix D, “MVS 
Configuration Program 
This sample MVS cotifiguration program input stream will help Example” on page D-1 
you become familiar with statement formats and input stream 
organization. 
(6) Review the MVS configuration program input statements: Chapter 5, “MVS 
Configuration Program 
This review will help you understand the purpose of each statement | Input Statement 
and will allow you to become familiar with statement parameters Reference” on page 5-1 
and the rules for coding statements. 
(7) Assign the I/O configuration identifier: “Assigning an I/O 
Configuration 
e Use the ID parameter on the IOCONFIG statement. Identifier” on page 8-3 
e Include the statement in the input stream. 
“TOCONFIG 
Statement” on page 5-7 
(8) Define the IOCP definitions: Input/Output 


Configuration Program 
@ Make planned [OCP changes to the ID, CHPID, CNTLUNIT, User's Guide and 
and IODEVICE statements previously saved. Reference 


If your plan calls for additional IOCP definitions, include the 
required statements in the input stream. 
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[Step | Migrating an I/O Configuration 


C (9) Define the I/O devices: Chapter 6, “Defining 
I/O Devices” on 
@ Make planned changes to the IODEVICE statements saved in page 6-1 
step 3. 
“Channel-to-Channel 
If the IODEVICE statements you saved contain any of the Adapter Definitions” 
following parameters (AP, DEVTYPE, ERRTAB, EXPBFR, on page 6-6 
OBRCNT, or OPTCHAN), it is suggested you remove those 
parameters. If you allow them to remain, the MVS “DASD Definitions” 
configuration program ignores the parameters, issues on page 6-8 
informational messages but, otherwise, works normally. 
“Display Device 
If any saved IODEVICE statement specifies Definitions” on 
UNIT =DUMMY, see “Migrating a Dummy Device” on page 6-24 
page 8-2. 


“Magnetic Tape Device 
To define additional devices, include the appropriate Definitions” on 
IODEVICE statements in the input stream. page 6-50 


“Miscellaneous I/O 
Device Definitions” on 
page 6-57 


“MSS Device 
Definitions” on 
page 6-67 


“Telecommunication 
Device Definitions” on 


page 6-70 


“Unit Record Device 
Definitions” on 
page 6-98 


“Migrating a Dummy 
Device” on page 8-2 


“IODEVICE 
Statement” on page 5-9 
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[Step | Migrating an 1/0 Configuration 


(10) | Define eligible device tables (EDTs): Chapter 7, “Defining 
Eligible Device Tables 
and NIP Consoles” on 
page 7-1 





















@ To define one EDT with no changes to the device preference 
table: 
You can code an EDT statement or omit it. If you omit the 
EDT statement, the EDT identifier defaults to the identifier 
(ID =) on the IOCONFIG statement. 












“EDT Statement” on 
page 5-4 





To define one EDT with changes to the device preference 
table: 

Code one EDT statement. If you omit the ID parameter 
from the EDT statement, the EDT identifier defaults to the 
identifier on the IOCONFIG statement. 













To define multiple EDTs: 
Code one EDT statement for each EDT. You may omit the 
ID parameter from one (but no more) of the EDT 
statements. If you omit the ID parameter, the EDT 
identifier defaults to the identifier on the IOCONFIG 

statement. 










Notes: 





I. No two EDTs can have the same identifier. If you specify the 
identifier of an existing EDT, the MVS configuration program 
replaces the existing EDT with the new EDT. 








Ensure that UNITNAME Statements immediately follow their 
corresponding EDT statement. 









JES3 supports only one EDT per I/O configuration. Therefore, 
JES3 installations should define only one EDT per I/O 
configuration. 


















Chapter 7, “Defining 
Eligible Device Tables 
and NIP Consoles” on 
page 7-1 


Define device preference table updates: 


(11) 






@ Code any updates on the DEVPREF parameter of the 
corresponding EDT statement. 













|@ If you saved the SCHEDULR statement in step 3, delete it. Appendix B, “IBM 
Provided Device 
Preference Table” on 


page B-1 










Note: In the SYSGEN input stream, changes to the device 
preference table were coded on the DEVPREF parameter of the 
SCHEDULER statement. 








Appendix A, “Generic 
Device Types” on 
page A-l 









“EDT Statement” on 
page 5-4 
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[Step | Migrating an 1/0 Configuration 


i. (12) 


: 
: 


\ id 





(13) 
- 


Define esoteric device groups: 


@ Make any planned changes to the UNITNAME statements 


saved in step 3. 


e To define additional esoteric device groups, code the required 
UNITNAME statements. Indicate, on the UNITNAME 
statements, whether the group is to be eligible for VIO. There 
will be one set of UNITNAME statements for each EDT. 


Place each set of UNITNAME statements immediately after 


the EDT statement to which they correspond. 


If the input stream contains no EDT statements, place the 
UNITNAME statements immediately after the last 


IODEVICE statement. 


Note: To determine which esoteric device groups your installation 
requires, review the cataloged procedures used at your installation 
(check the UNIT parameter on DD statements). If you use the 
IBM-provided SYS1.PROCLIB, you may have to define esoteric 
device groups SYSDA and SYSSQ. 


Identify VIO-eligible generic device types: 





@ Identify, ona UNITNAME statement, each generic device 
type that you want MVS to consider for VIO allocations. 


Define NIP consoles: 


Code device numbers on one or more NIPCON statements. 
NIP requires at least one console. 


If you define multiple consoles, NIP attempts to use them in 


the defined order. 


IBM recommends that you define the master console as the 


first NIP console. 


Define cataloged procedure overrides or SAMPLIB JCL changes: 


e If you use the cataloged procedure, include desired overrides in 


the invocation JCL. 


e If you use the SAMPLIB JCL, change it as needed. 










Group the UNITNAME statements after the EDT statement 
to which they correspond. 


“Defining Esoteric 
Device Groups” on 
page 7-5 


“Required Esoteric 
Device Groups” on 
page 7-5 


“Grouping EDT and 
UNITNAME 
Statements” on 

page 7-8 


“UNITNAME 
Statement” on 
page 5-18 





“Tdentifying 
VIO-Eligible Generic 
Device Types” on 

page 7-7 
















“Grouping EDT and 
UNITNAME 
Statements” on 

page 7-8 





“UNITNAME 
Statement” on 
page 5-18 


“Defining NIP 
Consoles” on page 7-9 





“NIPCON Statement” 
on page 5-16 


“Using the Cataloged 
Procedure or the 
SAMPLIB JCL” on 
page 8-3 


“Invoking the MVS 
Configuration 
Program” on page 8-16 


MVS/Extended 
Architecture JCL 
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(16) | Specify SYSIN and JES3 data set names: 


e SYSIN data set: 


Required data set. 


If you use the cataloged procedure, specify the data set 
name on the PROC statement’s DEFDATA parameter. 


If you use the SAMPLIB JCL, specify the data set name 
on the DSN parameter of the SYSIN DD statement. 


The SYSIN DD statement defines the data set. 


“Identifying the SYSIN 
and JES3 Data Sets” 
on page 8-12 


“Using the Cataloged 
Procedure or the 
SAMPLIB JCL” on 
page 8-3 


MVS/Extended 
Architecture: System 
Programming Library: 
JES3 Initialization and 


Tuning. 
JES3 data set: 


— Required only if you want the MVS configuration 
program to write data that the JES3 initialization stream 
checker can read. 


If you use the cataloged procedure, specify the data set 
name on the PROC statement’s JES3 parameter. 


If you use the SAMPLIB JCL, specify the data set name 
on the DSN parameter of the SYSJES3 DD statement. 


The SYSJES3 DD statement defines the data set. 


Select the mode of operation: 









“Selecting the Mode of 
Operation” on 
page 8-14 


(17) 



















e To build the migrated configuration, select IODEF mode. 















“Invoking the MVS 
Configuration 
Program” on page 8-16 


e To perform a syntax check and semantics check on the input 
statements, and to receive the reports without building the 
configuration, select VALIDATE mode. 







“Using the Cataloged 
Procedure or the 
SAMPLIB JCL” on 
page 8-3 


If you use the catalog procedure, specify mode on the TYPE 
parameter (the default is VALIDATE). 












e If you use the SAMPLIB JCL, specify mode on the PARM 
parameter of the EXEC statement (the default is VALIDATE). 


(18) | Invoke the MVS configuration program “Invoking the MVS 
Configuration 
Program” on page 8-16 
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( (19) | Determine if the run was successful: Chapter 10, “Debugging, 


Messages, and Codes” 

(20) | Verify the configuration: Chapter 9, “Reading 
MVS Configuration 

To confirm that you built the I/O configuration that you intended Program Reports” on 


















@ Check the JES job log and the files SYSASMP, SYSLKEDP, 
SYSLOUT, and SYSPRINT for messages that indicate 
possible errors. 








“Verifying MVS 
Configuration Program 
Output” on page 8-19 













@ Check the SYSRPT file to ensure that you received the 
expected reports. 









Chapter 9, “Reading 
MVS Configuration 

Program Reports” on 
page 9-1 






e If there are no error messages and you received the expected 
reports, continue with the next numbered step in this 
procedure. 










If there are error messages or reports are missing, follow the 
instructions given in the topic “Verifying MVS Configuration 
Program Output” on page 8-19. 


on page 10-1 
to build, compare your configuration plan to the MVS page 9-1. 
configuration program reports. 


(21) | If you selected VALIDATE mode: None 
e If you now wish to build the configuration, repeat the 
procedure from step 17, this time selecting IODEF mode. 
(22) 
Use the utility program IEBCOPY or a similar program. 


Copy the I/O configuration members to the SYS1.NUCLEUS data 
(23) | Invoke the IOCP: See the publication 
IOCP User's Guide and 
You must invoke the IOCP if: Reference 
@ You do not have an IOCDS on which the I/O configuration is 
defined. 




















MVS/Extended 














set: Architecture Data 
Administration: 
e Do this step only if the I/O configuration output data set Utilities 


(defined by the //SYSLMOD DD statement) is a data set other 
than the SYS1.NUCLEUS data set of the system on which the 
configuration will be used. 


@ You have an IOCDS but you have added, deleted, or updated 
one or more of the following statements: CHPID, 
CNTLUNIT, ID, or IODEVICE. 





Note: If you wish to validate an EDT, see Appendix E, “Eligible Device Table 
Verification Service” on page E-1. 
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Updating an Existing I/O Configuration 


When to Do Procedure 


Procedure Input 


Procedure Output 


This procedure updates an existing I/O configuration that was previously migrated 
or defined through the MVS configuration program. 


Note: If you are unfamiliar with this procedure, read it through completely 


before using it. You should also review the detailed information referred to by 
each step. 





Anytime there is a need to update an I/O configuration previously migrated or 
defined through the MVS configuration program. 


The combined MVS configuration program/IOCP input stream that currently 
defines the configuration. 


The data set that contains the MVS internal representation of the I/O 
configuration. 


The MVS configuration program, the IBM-provided cataloged procedure or 
the IBM-provided SAMPLIB member, and macro library (SYS1.MACLIB), 
must be available on the system where you intend to execute the MVS 
configuration program. 


If you must execute IOCP (See step 21 of this procedure): 


— JOCP and its input libraries. 
— The publication JOCP User's Guide and Reference. 


The MVS internal representation of the I/O configuration:. 


— If you execute the MVS configuration program in EDT mode, the MVS 
configuration program writes only IEFEDTxx members. (it writes a 
separate member for each EDT.) 


— If you execute the MVS configuration program in IODEF mode, the 
MVS configuration program writes a separate IEFEDTxx member for 
each EDT and one each of the members IEANCTxx, IOSIITxx, and 
IOSUCBxx. 


— The MVS configuration program writes these members to the data set 
defined by the SYSLMOD DD statement. 


If you execute IOCP, JOCP writes the channel subsystem’s internal 
representation of the I/O configuration data to the IOCDS. 


Reports and messages. 
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JI 





Procedure Activities 


C 


Step | Updating an I/O Configuration 


Plan the update: Chapter 3, “Planning an 
I/O Configuration” on 
e Review the existing configuration plan and configuration page 3-l 


(1) 


(2) 


(3) 


(4) 


reports. 

“Requesting Reports and 
Define the changes and document them in your configuration Validating the Input 
plan. Stream” on page 9-2 








“Ordering Statements in 
the Input Stream” on 
page 8-13 





Review recommended order of MVS configuration program input 
stream: 







IOCONFIG 
ID 

CHPID 
CNTLUNIT 
IODEVICE 
EDT 
UNITNAME 
NIPCON 








Notes: 









l. EDT statements, if used, must immediately precede their related 
UNITNAME statements. 


Assembler comment statements may appear anywhere in the 
input stream. 






Do not include an END statement or any other statement not 
listed above in the input stream. 
















Review input stream example: Appendix D, “MVS 
Configuration Program 


Example” on page D-1 






This sample MVS configuration program input stream will help 
you become familiar with statement formats and input stream 
organization. 














Review the MVS configuration program input statements: Chapter 5, “MVS 
Configuration Program 
Input Statement 


Reference” on page 5-1 






This review will help you understand the purpose of each statement 
and will allow you to become familiar with statement parameters 
and the rules for coding statements. 
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Updating an 1/0 Configuration 


Update I/O device definitions: 
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Chapter 6, “Defining I/O 
Devices” on page 6-1 







@e To add a device -- 
include a new IODEVICE statement. 













“Channel-to-Channel 
Adapter Definitions” on 
page 6-6 






e To delete a device -- 
remove the corresponding IODEVICE statement. 


“DASD Definitions” on 
page 6-8 








Note: Also remove the device number from all UNITNAME 
statements and NIPCON statements on which it appears. 






“Display Device 
Definitions” on page 6-24 






Be especially careful to remove device numbers that are 
specified on the IODEVICE statement through the use of 
the number-of-units subparameter, they are easy to miss. 







“Magnetic Tape Device 
Definitions” on page 6-50 









When you finish this step, be sure the input stream 
contains at least one NIPCON statement. 







“Miscellaneous I/O 
Device Definitions” on 
page 6-57 






e To change device information -- 
change the information on the corresponding IODEVICE 
statement. 













“MSS Device Definitions” 
on page 6-67 





“Telecommunication 
Device Definitions” on 
page 6-70 





“Unit Record Device 
Definitions” on page 6-98 


“TODEVICE Statement” 
on page 5-9 















“Defining Esoteric Device 
Groups” on page 7-5 


Update an esoteric device group: 










e To add a device to a group -- 
include the device number(s) on the corresponding 
UNITNAME statement. 










“UNITNAME 
Statement” on page 5-18 









To delete a device from a group -- 
remove the device number(s) from the corresponding 
UNITNAME statement. 


Delete an esoteric device group: 







None 


@ Remove the corresponding UNITNAME statement(s) from the 
input stream. 









Note: To ensure that you do not delete an esoteric device group 
that you still require, review the cataloged procedures used at your 
installation (check the UNIT parameter on DD statements). If 
your installation uses the IBM-provided SYS1.PROCLIB, you 
probably require esoteric device groups SYSDA and SYSSQ. 


2 





Updating an 1/0 Configuration 


C (8) Update a device preference table definition: Chapter 7, “Defining 

Eligible Device Tables 
and NIP Consoles” on 
page 7-1 























e To define updates, use the DEVPREF parameter on the 
appropriate EDT statement. 








Appendix B, “IBM 
Provided Device 

Preference Table” on 
page B-! 





If the input stream contains no EDT statement, you must code 
one. 





Appendix A, “Generic 
Device Types” on 
page A-1 


“EDT Statement” on 
page 5-4 
Chapter 7, “Defining 
Eligible Device Tables 
and NIP Consoles” on 
page 7-1 












(9) Define an additional eligible device table (EDT): 







e If the input stream contains no EDT statements: 





— Code two EDT statements: One for the previously defined 
EDT and one for the additional EDT. 






“EDT Statement” on 
page 5-4 























Assign each EDT an identifier. 


To change the device preference table definition, use the 
DEVPREF parameter on the EDT statement. 


e If the input stream contains EDT statements: 
Code an EDT statement for the additional EDT. 
Assign the EDT an identifier. 


To change the device preference table definition, use the 
DEVPREF parameter on the EDT statement. 


Notes: 
1. No two EDTs can have the same identifier. If you specify the 


identifier of an existing EDT, the MVS configuration program 
replaces the existing EDT with the new EDT. 





Ensure that UNITNAME statements immediately follow their 
corresponding EDT statement. 





JES3 supports only one EDT per I/O configuration. Therefore, 
JES3 installations should define only one EDT per I/O 
configuration. 
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(10) | Define a new esoteric device group: “Defining Esoteric Device j 
Groups” on page 7-5 
e Define the group on a UNITNAME statement. Indicate 
whether the group 1s to be eligible for VIO. “Grouping EDT and 
UNITNAME Statements” 
@ Place the UNITNAME statement into the input stream on page 7-8 
following the corresponding EDT statement. 
“UNITNAME 
Statement” on page 5-18 
(11) | Identify VIO-eligible generic device types: “Tdentifying VIO-Eligible 
Generic Device Types” on 
e Identify, on a UNITNAME statement, each generic device page 7-7 
type that you want MVS to consider for VIO allocations. 
“Grouping EDT and 
@ Group the UNITNAME statements after the EDT statement UNITNAME Statements” 
to which they correspond. on page 7-8 
“UNITNAME 
Statement” on page 5-18 









Update NIP console definition: “Defining NIP Consoles” 


on page 7-9. 










Add or remove device numbers on the NIPCON statements. 








“NIPCON Statement” on 
page 5-16 





NIP requires at least one console. 





If you define multiple consoles, NIP attempts to use them in 
the defined order. 





IBM recommends that you define the master console as the 


(12) 
first NIP console. 


(13) | Define cataloged procedure overrides or SAMPLIB JCL changes: “Using the Cataloged 
Procedure or the 
e If you use the cataloged procedure, include desired overrides in | SAMPLIB JCL” on 


the invocation JCL. page 8-3 
e If you use the SAMPLIB JCL, change it as needed. “Invoking the MVS 


Configuration Program” 
on page 8-16 


MVS/Extended 
Architecture JCL 
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' [Step | Updating an 1/0 Configuration 


(14) | Specify SYSIN and JES3 data set names: “Identifying the SYSIN 
and JES3 Data Sets” on 
e SYSIN data set: page 8-12 


Required data set. “Using the Cataloged 
Procedure or the 

If you use the cataloged procedure, specify the data set SAMPLIB JCL” on 

name on the PROC statement’s DEFDATA parameter. page 8-3 


If you use the SAMPLIB JCL, specify the data set name MVS/Extended 
on the DSN parameter of the SYSIN DD statement. Architecture: System 
Programming Library: 
— The SYSIN DD statement defines the data set. JES3 Initialization and 
Tuning. 
JES3 data set: 


— Required only if you want the MVS configuration program 
to write data that the JES3 initialization stream checker 
can read. 


If you use the cataloged procedure, specify the data set 
name on the PROC statement’s JES3 parameter. 


If you use the SAMPLIB JCL, specify the data set name 
on the DSN parameter of the SYSJES3 DD statement. 


The SYSJES3 DD statement defines the data set. 





































































(15) | Select the mode of operation: “Selecting the Mode of 
L Operation” on page 8-14 
e If you added, deleted, or changed UNITNAME statements, 
EDT statements, or both, and made no other changes, youcan | “Invoking the MVS 
select either EDT mode or IODEF mode. Configuration Program” 
on page 8-16 
For all other changes, select IODEF mode. 
“Using the Cataloged 
e To perform a syntax check and semantics check on the input Procedure or the 
statements, and to receive the reports without building the SAMPLIB JCL” on 
configuration, select VALIDATE mode. page 8-3 
If you use the cataloged procedure, specify mode on the TYPE 
parameter (the default is VALIDATE). 
If you use the SAMPLIB JCL, specify mode on the PARM 
parameter of the EXEC statement (the default is VALIDATE). 
(16) | Invoke the MVS configuration program “Invoking the MVS 


Configuration Program” 
on page 8-16 
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[Step | Updating an 1/0 Configuration 


Determine if the run was successful: Chapter 10, “Debugging, 
Messages, and Codes” on 
page 10-1 






9 












e Check the JES job log and the files SYSASMP, SYSLKEDP, 
SYSLOUT, and SYSPRINT for messages that indicate errors. 










“Verifying MVS 
Configuration Program 
Output” on page 8-19 






e@e Check the SYSRPT file to ensure that you received the 
expected reports. 












If there are no error messages and you received the expected 
reports, continue with the next numbered step in this 
procedure. 


Chapter 9, “Reading 
MVS Configuration 

Program Reports” on 
page 9-1 













e If there are error messages or reports are missing, follow the 
instructions given in the topic “Verifying MVS Configuration 
Program Output” on page 8-19. 











Verify the configuration: Chapter 9, “Reading 
MVS Configuration 
Program Reports” on 


page 9-1. 











To confirm that you built the I/O configuration that you intended 
to build, compare your configuration plan to the MVS 
configuration program reports. 


If you selected VALIDATE mode: None 


e If you now wish to build the configuration, repeat the 
procedure from step 15, this time selecting IODEF mode or 
EDT mode as appropriate. 


Copy the I/O configuration members to the SYSI.LNUCLEUS data 
set: 













MVS/Extended 
Architecture Data 
Administration: 

Utilities 












e Do this step only if the I/O configuration output data set 

(defined by the //SYSLMOD DD statement) is a data set other 
than the SYSI1.NUCLEUS data set of the system on which the 
configuration will be used. 


Use the utility program IEBCOPY or a similar program. 


Invoke the IOCP: See the publication JOCP 
User's Guide and 
You must invoke the IOCP if: Reference 


@e You added, deleted, or changed an IOCP statement or an 
IODEVICE statement. 





Note: If you wish to validate an EDT, see Appendix E, “Eligible Device Table 
Verification Service” on page E-1. 
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Defining a New I/O Configuration 


When to Do Procedure 


Procedure Input 


Procedure Output 


This procedure defines a new I/O configuration. A new I/O configuration is one 
whose identifier is currently undefined. 


Note: If you are unfamiliar with this procedure, read it through completely 


before using it. You should also review the detailed information referred to by 
each step. 





During the MVS/System Product Version 2 Release 2 or subsequent release install 
process or anytime thereafter. 


The MVS configuration program, the IBM-provided cataloged procedure or 
the IBM-provided SAMPLIB member, and macro library (SYS1.MACLIB), 
must be available on the system where you intend to execute the MVS 
configuration program. 

IOCP and its input libraries. 


The publication JOCP User's Guide and Reference. 


The MVS configuration program writes the internal representation of the I/O 
configuration to PDS members, IEANCTxx, IOSIITxx, IOSUCBxx, and 
IEFEDTxx. 


— The MVS configuration program writes one each of the following 
members: IEANCTxx, IOSIITxx, and IOSUCBxx. 


— The MVS configuration program writes one IEFEDTxx member for each 
EDT. 


— The MVS configuration program writes all of these members to the data 
set defined by the SYSLMOD DD statement. 


IOCP writes the channel subsystem’s internal representation of the I/O 
configuration to the IOCDS. 


Reports and messages. 


(continued on next page) 
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Procedure Activities 


[Step [Defining « New 1/0 Configuration 


Plan the configuration: Chapter 3, “Planning an 


( 


(3) 
(4) 
(5) 
(6) 


I/O Configuration” on 
Document the I/O configuration in your configuration plan. page 3-1 








Review recommended order of MVS configuration program input 
stream: 


“Ordering Statements in 
the Input Stream” on 
page 8-13 










IOCONFIG 
ID 

CHPID 
CNTLUNIT 
IODEVICE 
EDT 
UNITNAME 
NIPCON 










Appendix D, “MVS 
Configuration Program 
Example” on page D-1 


Notes: 


1. EDT statements, if used, must immediately precede their related 
UNITNAME statements. 


Assembler comment statements may appear anywhere in the 
input stream. 


Do not include an END statement or any other statement not 
listed above in the input stream. 


Review input stream example: Appendix D, “MVS 

Configuration Program 
This sample input stream will help you become familiar with Example” on page D-1 
statement formats and input stream organization. 


Review the MVS configuration program input statements: Chapter 5, “MVS 
Configuration Program 

This review will help you understand the purpose of each statement | Input Statement 

and will allow you to become familiar with statement parameters Reference” on page 5-1 

and the rules for coding statements. 


Assign the I/O configuration identifier: “Assigning an I/O 
Configuration Identifier” 

@ Use the ID parameter on the IOCONFIG statement. on page 8-3 

e Include the statement in the input stream. 


“IOCONFIG Statement” 
on page 5-7 


Define the IOCP definitions: Input/Output 

Configuration Program 
Include the IOCP statements ID, CHPID, and CNTLUNIT in the User's Guide and 
input stream. Reference 
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Defining a New 1/0 Configaration 


(7) Define I/O devices: Chapter 6, “Defining I/O 
Devices” on page 6-1 































@ Define each device on an IODEVICE statement. 
@ Include the IODEVICE statements in the input stream. 





“Channel-to-Channel 
Adapter Definitions” on 
page 6-6 


“DASD Definitions” on 
page 6-8 





“Display Device 
Definitions” on page 6-24 





“Magnetic Tape Device 
Definitions” on page 6-50 





“Miscellaneous I/O 
Device Definitions” on 
page 6-57 


“MSS Device Definitions” 
on page 6-67 















“Telecommunication 
Device Definitions” on 
page 6-70 





“Unit Record Device 
Definitions” on page 6-98 


“TODEVICE Statement” 
on page 5-9 
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[Step _| Defining a New 1/0 Configuration 


(8) Define eligible device tables (EDTs): Chapter 7, “Defining 
Eligible Device Tables 
and NIP Consoles” on 
page 7-1 











~ 










If your plan calls for: 














@ One EDT with no changes to the device preference table: 
You may omit the EDT statement. If you omit the EDT 
statement, the EDT identifier defaults to the identifier (ID =) 
on the IOCONFIG statement. 






“EDT Statement” on 
page 5-4 













One EDT with changes to the device preference table: 
Code one EDT statement. If you omit the ID parameter from 
the EDT statement, the EDT identifier defaults to the 

identifier on the ILOCONFIG statement. 
















Multiple EDTs: 
Code one EDT statement for each EDT. You may omit the 
ID parameter from one (but no more) of the EDT statements. 
If you omit the ID parameter, the EDT identifier defaults to 
the identifier on the IOCONFIG statement. 


Notes: 
1. No two EDTs can have the same identifier. If you specify the 


identifier of an existing EDT, the MVS configuration program 
replaces the existing EDT with the new EDT. 





Ensure that UNITNAME statements immediately follow their 
corresponding EDT statement. 


JES3 supports only one EDT per I/O configuration. Therefore, 
JES3 installations should define only one EDT per I/O 
configuration. 


(9) Define device preference table updates: Chapter 7, “Defining 

Eligible Device Tables 

To define updates, use the DEVPREF parameter on the EDT and NIP Consoles” on 
statements to which the updates correspond. page 7-1 


Appendix B, “IBM 
Provided Device 
Preference Table” on 
page B-1 


Appendix A, “Generic 
Device Types” on 
page A-1 


“EDT Statement” on 
page 5-4 
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(10) 


Define esoteric device groups: 











e Define each group on a UNITNAME statement. Indicate 
whether the group is to be eligible for VIO. 





e Place the UNITNAME statements after the EDT statement to 
which they correspond. 






e Ifthe input stream contains no EDT statements, place the 
UNITNAME statements after the last IODEVICE statement. 













Note: To determine which esoteric device groups your installation 
requires, review the cataloged procedures used at your installation 
(check the UNIT parameter on DD statements). If you use the 
IBM-provided SYS1.PROCLIB, you may have to define esoteric 
device groups SYSDA and SYSSQ. 


Identify VIO-eligible generic device types: 


e Identify, ona UNITNAME statement, each generic device 
type that you want MVS to consider for VIO allocations. 


Place the UNITNAME statements after the EDT statement to 
which they correspond. 


Define NIP consoles: 
Code device numbers on NIPCON statements. 
NIP requires at least one console. 


If you define multiple consoles, NIP attempts to use them in 
the defined order. 


IBM recommends that you define the master console as the 
first NIP console. 
Define cataloged procedure overrides or SAMPLIB JCL changes: 


e If you use the cataloged procedure, include desired overrides in 
the invocation JCL. 


e If you use the SAMPLIB JCL, change it as needed. 
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[Step | Defining a New 1/O Configuration 


“Defining Esoteric Device 
Groups” on page 7-5 








“Required Esoteric 
Device Groups” on 
page 7-5 


“Grouping EDT and 
UNITNAME Statements” 
on page 7-8 


“UNITNAME 
Statement” on page 5-18 


“Identifying VIO-Eligible 
Generic Device Types” on 
page 7-7 


“Grouping EDT and 
UNITNAME Statements” 
on page 7-8 


“UNITNAME 
Statement” on page 5-18 


“Defining NIP Consoles” 
on page 7-9. 


“NIPCON Statement” on 
page 5-16 


“Using the Cataloged 
Procedure or the 
SAMPLIB JCL” on 
page 8-3 


“Invoking the MVS 
Configuration Program” 
on page 8-16 


MVS/Extended 
Architecture JCL 
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[Step | Defining « New 1/0 Configuration 


(14) | Specify SYSIN and JES3 data set names: “Identifying the SYSIN 
and JES3 Data Sets” on 
e SYSIN data set: page 8-12 


Required data set. “Using the Cataloged 
Procedure or the 

If you use the cataloged procedure, specify the data set SAMPLIB JCL” on 

name on the PROC statement’s DEFDATA parameter. page 8-3 


If you use the SAMPLIB JCL, specify the data set name MVS/Extended 
on the DSN parameter of the SYSIN DD statement. Architecture: System 
Programming Library: 
— The SYSIN DD statement defines the data set. JES3 Initialization and 
Tuning. 
JES3 data set: 


— Required only if you want the MVS configuration program 
to write data that the JES3 initialization stream checker 
can read. 


If you use the cataloged procedure, specify the data set 
name on the PROC statement’s JES3 parameter. 


If you use the SAMPLIB JCL, specify the data set name 
on the DSN parameter of the SYSJES3 DD statement. 


The SYSJES3 DD statement defines the data set. 
Select the mode of operation: 











“Selecting the Mode of 
Operation” on page 8-14 


(15) 
















e To build the new configuration, select IODEF mode. 





“Invoking the MVS 
Configuration Program” 
on page 8-16 












e To perform a syntax check and semantics check on the input 
statements, and to receive the reports without building the 
configuration, select VALIDATE mode. 








“SYS1.PROCLIB(MVSCP) 
Cataloged Procedure” on 
page 8-4 






e If you use the cataloged procedure, specify mode on the TYPE 
parameter (the default is VALIDATE). 











If you use the SAMPLIB JCL, specify mode on the PARM 
parameter of the EXEC statement (the default is VALIDATE). 


“Using the Cataloged 
Procedure or the 
SAMPLIB JCL” on 
page 8-3 


(16) | Invoke the MVS configuration program “Invoking the MVS 
Configuration Program” 
on page 8-16 
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Check the JES job log and the files SYSASMP, SYSLKEDP, 
SYSLOUT, and SYSPRINT for messages that indicate 
possible errors. 


Check the SYSRPT file to ensure that you received the 
expected reports. 


If there are no error messages and you received the expected 
reports, continue with the next numbered step in this 
procedure. 


If there are error messages or reports are missing, follow the 
instructions given in the topic “Verifying MVS Configuration 
Program Output” on page 8-19. 


Verify the configuration: 
To confirm that you built the I/O configuration that you intended 


to build, compare your configuration plan to the MVS 
configuration program reports. 


If you selected VALIDATE mode: 


e If you now wish to build the configuration, repeat the 
procedure from step 15, this time selecting IODEF mode. 


Copy the I/O configuration members to the SYS1.NUCLEUS data 
Set: 


e Do this step only if the I/O configuration output data set 
(defined by the //SYSLMOD DD statement) is a data set other 
than the SYSI1.NUCLEUS data set of the system on which the 
configuration will be used. 


Use the utility program JEBCOPY or a similar program. 
Invoke the IOCP 


Chapter 10, “Debugging, 
Messages, and Codes” on 
page 10-1 


“Verifying MVS 
Configuration Program 
Output” on page 8-19 


Chapter 9, “Reading 
MVS Configuration 
Program Reports” on 
page 9-1 


Chapter 9, “Reading 
MVS Configuration 
Program Reports” on 
page 9-1. 


MVS/Extended 
Architecture Data 
Administration: 
Utilities 


See the publication JOCP 
User's Guide and 
Reference 





Note: If you wish to validate an EDT, see Appendix E, “Eligible Device Table 


Verification Service” on page E-1. 
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Deleting an I/O Configuration 





This procedure deletes an I/O configuration definition and the corresponding I/O J 
configuration data. 


Note: If you are unfamiliar with this procedure, read it through completely 


before using it. You should also review the detailed information referred to by 
each step. 





When to Do Procedure 


Anytime there is an I/O configuration that is no longer needed. 


Warning: Do not delete a system’s last I/O configuration. If you 
do, you will be unable to re-IPL MVS on that system until you 


define another configuration. 





Procedure Input 
e The SYSI.NUCLEUS data set that contains the I/O configuration data. 


_ 
e The data set that contains the MVS configuration program input statements 2 
(the I/O configuration definition). 


@ The publication MVS/Extended Architecture Data Administration: Utilities. 


Procedure Output 
e The I/O configuration definition is scratched from its data set. 


e The I/O configuration data (members IEANCTxx, IOSIITxx, IOSUCBxx, 
and IEFEDTxx) is scratched from the SYS].NUCLEUS data set. 
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Procedure Activities 


Delete an 1/0 Configuration 


Scratch members IEANCTxx, IOSITTxx, and IOSUCBxx: MVS/Extended 
Architecture Data 
The value xx is the identifier of the I/O configuration. It is Administration: 
found on the IOCONFIG statement. Utilities 


Use the utility program IEHPROGM or a similar program. 


Scratch IEFEDTxx member(s): MVS/Extended 
Architecture Data 
@ There is one member for each EDT defined. Scratch each Administration: 
member. Utilities 


The value xx corresponds to the identifier (ID) specified on 
each EDT statement. 


If there are no EDT statements, or there is an EDT statement 
that omits the ID parameter, the value xx corresponds to the 
identifier specified on the IOCONFIG statement. 


Use utility program IEHPROGM or a similar program. 


Scratch the I/O configuration definition: MVS/Extended 
Architecture Data 

e Use utility program JEHPROGM or a similar program. Administration: 
Utilities 
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Deleting an Eligible Device Table (EDT) 





This procedure deletes an EDT member (IEFEDTxx) and the corresponding J 
statements from the I/O configuration definition. 


Note: If you are unfamiliar with this procedure, read it through completely 


before using it. You should also review the detailed information referred to by 
each step. 





When to Do Procedure 


Anytime the installation has an EDT that it no longer needs. 


Procedure Input 
e The SYSI.NUCLEUS data set that contains the I/O configuration data. 


e The data set that contains the MVS configuration program input statements 
(the I/O configuration definition). 


@ The publication MVS/Extended Architecture Data Administration: Utilities . 


Procedure Output } 


@ The EDT is deleted from the I/O configuration definition. 


e The I/O configuration data (member IEFEDTxx is scratched from the 
SYS1.NUCLEUS data set. 
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Procedure Activities 


Scratch the IEFEDTxx member: MVS/Extended 
Architecture Data 
Administration: 
Utilities 
























@ The value xx is the identifier of the EDT. 
@ Use the utility program IEHPROGM or a similar program. 








Note: xx is the identifier assigned to the EDT at the time the 
EDT was built. 


Update the I/O configuration data: 













@e Remove, from the I/O configuration data, the EDT statement 
and UNITNAME statements that correspond to the 
TEFEDTxx member scratched. 





Use the edit program normally used at your installation for 
this purpose. 











Print a Configuration Report: “Requesting Reports and 
Validating the Input 


Stream” on page 9-2 













@ The report reflects the configuration with the EDT deleted. 


e For future reference, file the report with the configuration 
plan. 
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Chapter 5. MVS Configuration Program Input Statement Reference 


There are five types of input statements that you use to define an I/O 
configuration to the MVS configuration program. The statements are: 


e EDT 

e IOCONFIG 
e IODEVICE 

e NIPCON 

e UNITNAME 


This chapter: 


e Explains the conventions and syntax that this book uses to describe the 
statements. 


e Contains a description of each statement and its parameters. 
[ 


Locating Information in this Chapter 


This chapter contains the following major topics: 


Coding Rules for Input Statements 5-2 
EDT Statement 5-4 

IOCONFIG Statement 5-7 
IODEVICE Statement 5-9 

NIPCON Statement 5-16 
UNITNAME Statement 5-18 
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Statement Coding Rules 


Coding Rules for Input Statements 


Statement Format 


The rules for coding input statements are the same rules that must be followed to J 
code Assembler statements. The following paragraphs are a summary of these 

rules as stated in Assembler H Version 2 Application Programming: Language 

Reference and Assembler H Version 2 Application Programming: Guide. 


@ Code each statement in columns | through 71 only. 


e Use one or more blanks to separate each field, name, Operation, Operand, 
and comments from adjacent fields. 


e Use column 72 only to indicate continuation. 


e Use columns 73 through 80 for sequence numbers or other 
installation-defined information. The MVS configuration program does not 
use this information. 


Each input statement must conform to the following format: 


Statement Required and Optional 
name optional 
parameters 


name ) 


Symbolically identifies the statement. The MVS configuration program does 
not use this optional field. If included, name must contain from | through 8 
alphameric or national characters, the first of which must be alphabetic or 
national. 

















Do not code @ as the first character because the MVS configuration 
program uses it internally. 


If you code name, it must start in column one. 


Operation 
Identifies the specific input statement. For example, IODEVICE, or 
UNITNAME. 


This field must not start in column one. If you also code the Name field, 
separate the Name and Operation fields by at least one blank. 


Operand 
Contains statement parameters separated by commas. 


A parameter consists of a keyword followed by an equal (=) sign and the 
keyword value. The keyword value may be a single value or a list of values. 
If you code a list of values, use commas to separate the values and enclose 
the entire list in parentheses. 


This field ends with one or more blanks placed after the last parameter. ) 
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Statement Coding Rules 


comment 


Continuing a Statement 


Comments are optional. Use one or more blanks to separate the last 
operand from the comment. To place a comment only on a statement, code 
an aSterisk in the first column of the statement and follow the asterisk with 
the comment. 


To continue an input statement: 


Interrupt the statement that is to be continued (the continued statement) 
either in column 71 or after any comma. 


Code a non-blank character in column 72. 
Start coding the next statement (the continuation statement) in column 16. 


You can code comments on a continued statement or on a continuation 
statement. 


The Syntax Used to Describe Input Statements 


This book uses the following notation to describe the format of the input 
statements. This notation is not part of the statement language. It is merely a 
tool that serves to describe the statement format and structure. 


Brackets [ ] indicate an optional parameter. 


Braces { } indicate a choice of entry; unless a default is indicated, you must 
select one of the entries. 


Items separated by a vertical bar | represent alternative items. Select no more 
than one of these items. 


An ellipsis (...) indicates that multiple entries of the type immediately 
preceding the ellipsis are allowed. 


Other punctuation (parentheses, commas, spaces, etc.) must be entered as 
shown. A space is indicated by a blank. 


BOLDFACE type indicates the exact characters to be entered. Such items 
must be entered exactly as illustrated. 


Lowercase italicized type identifies fields that you must supply. 


BOLDFACE UNDERSCORED type indicates a default value. If you omit 
the parameter, the MVS configuration program uses the default value. 


If you code more than one value for a parameter, enclose the values in 
parentheses ( ). If you code only one value, omit the parentheses. 
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EDT Statement 


EDT Statement 


Use the EDT statement to: 
e Assign an identifier to an eligible device table (EDT) 


@ Redefine the order that MVS is to use when attempting to satisfy an 
allocation request 


To MVS, the identifier distinguishes one eligible device table from another. The 
system operator may use the identifier to select an eligible device table during IPL 
processing. 


The order of devices in the IBM-supplied device preference table is shown in 
Appendix B, “IBM Provided Device Preference Table” on page B-1. 


For a list of valid generic names, see Appendix A, “Generic Device Types” on 
page A-l. 


Rules for coding input statements are in “Coding Rules for Input Statements” on 
page 5-2. 





name 
A |-to-8 character name. The MVS configuration program ignores this 
name. You may wish to code it, however, to help you identify your input 
statements. 


ID= xx 
Assigns the identifier, xx, to an eligible device table. The identifier xx can 
be any two-digit alphanumeric value. You can assign each digit a value 0-9 
or A-Z. 


Default: 
e The identifier that appears on the IOCONFIG statement. 


e If you code multiple EDT statements, you may omit the ID= parameter 
from only one of those statements. If you omit it from more than one 
statement, the MVS configuration program will perform a semantic 
check on the rest of the input statements and will then terminate. The 
I/O configuration will not be built. 


The MVS configuration program assigns this identifier to the eligible device 
table that it creates from the UNITNAME statements that immediately 
follow this EDT statement. The next EDT statement encountered or the 
end of the input stream marks the end of this eligible device table definition. 
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Required /Optional 


Placement 


EDT Statement 


Note: If you define only one eligible device table, IBM recommends that 
you assign it the same identifier as the I/O configuration data. This will 
simplify EDT selection for the operator during IPL. 


DEVPREF = (genericname|,genericname]..) 
Redefines the device order that MVS is to use when attempting to satisfy an 
allocation request. MVS attempts to allocate devices from each generic type 
in the order you have listed them, left-to-right, until the request is satisfied. 


If MVS cannot satisfy the request using the specified order, MVS continues 
the attempt by using the order defined in the IBM-supplied device 
preference table. As MVS goes through the device preference table 
attempting to allocate devices, it might encounter generic device types that 
you specified on the DEVPREF parameter. Because MVS already 
attempted, unsuccessfully, to allocate devices from that generic device type, 
it now bypasses that type and goes on to the next generic device type in the 
table. 


The variable genericname must be a valid generic name. It may be an 
IBM-defined generic name or an installation-defined generic name. 
IBM-defined generic names are listed in Appendix A, “Generic Device 
Types” on page A-1. Installation-defined generic names are defined in the 
UIMs that your installation provides. 


If you specify only one generic name, you can omit the parentheses. 
Default: 


e The MVS configuration program uses the IBM-supplied device 
preference table without additions or changes. 


e If only one eligible device table is to be defined, you can omit the EDT 
statement. If you do omit it, the MVS configuration program assigns the 
eligible device table the ID that appears on the IOCONFIG statement. 


e If you are defining multiple eligible device tables on one invocation of the 


MVS configuration program, this statement is required. You must include 
one statement for each eligible device table you wish to define. 


e If there is only one EDT statement, place it ahead of all UNITNAME 
statements. 


e If there are multiple EDT statements, place each one immediately ahead of 
the UNITNAME statements that define its related eligible device table. 
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EDT Statement 


Example 1 


This example shows a partial input stream. The installation has omitted an EDT 
statement from the stream. 





The MVS configuration program will use all of the UNITNAME statements to 
create a single eligible device table. This table will have an ID of AB by default. 
The device preference table will be unchanged. 


IOCONFIG ID=AB 
TODEV DCIS | is8 donne te 
TODEV ICE -sas.0% 


UNITNAME ..... 
UNITNAME ..... 


NIPCON ie Geers 
Example 2 


This example shows a partial input stream. From these statements, the MVS 
configuration program will create two eligible device tables. 


The first table will contain the esoteric names specified on the two UNITNAME 
statements that immediately follow the first EDT statement. This table has an ID 
of 01. Whenever the installation uses this eligible device table, the IBM-supplied 
device preference table will be used unchanged. 


The second eligible device table will contain the esoteric names specified on the J 
three UNITNAME statements that follow the second EDT statement. This table 

will have an ID of 02. Whenever the installation uses this table, the device 

preference table will be changed so that the 3330 and the 3340 appear first. 


IOCONFIG ID=99 
TOQDEV ICE. 6 asue0« 
TODEVICE 4.24 


EDT ID=01 

UNITNAME ..... 

UNITNAME ..... 

EDT ID=02,DEVPREF=(3330,3340) 
UNITNAME ..... 

UNITNAME ..... 

UNITNAME ..... 

NIPCON ..... 
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IOCONFIG Statement 


IOCONFIG Statement 


Required/Optional 


Placement 


Use the IOCONFIG statement to assign an identifier to the I/O configuration 
data. 


For MVS, the identifier distinguishes one I/O configuration from another. The 
system operator may use the identifier to select an I/O configuration during IPL 
processing. 


Rules for coding input statements are in “Coding Rules for Input Statements” on 
page 5-2. 


name 
A 1-to-8 character name. The MVS configuration program ignores this 
name. You may wish to code it, however, to help you identify your input 
statements. 


ID=xx 
Assigns the identifier, xx, to the I/O configuration. The identifier xx can be 
any two-digit alphanumeric value. You can assign each digit a value 0-9 or 
A-Z. 


Note: During IPL, if the operator allows the I/O configuration selection to 
default, the system will use the configuration that has the identifier 00. 


Default: None 


This statement is required. Include one and only one IOCONFIG statement in 
the input stream. 


If the IOCONFIG statement is omitted from the input stream or the input stream 
contains multiple IOCONFIG statements, the MVS configuration program will 
perform a semantic check of the input stream and will then terminate. The I/O 
configuration will not be built. 


This statement may appear anywhere in the input stream. To provide an order to 
the input stream and to make it easier to read, however, you should place the 
IOCONFIG statement first. 
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IOCONFIG Statement 


Example 


This example shows a partial input stream. From these statements, the MVS —_ 
configuration program will create I/O configuration data. This data will have an 

ID of Al and will include three eligible device tables. The first eligible device 

table will have an ID of 01, the second an ID of 02, and the third an ID of Al 

(by default). 


IOCONFIG ID=Al1 
LODEV.ECE...a ace veg 


EDT ID=01 
UNITNAME ..... 


EDT ID=02 
UNITNAME ..... 


EDT 
UNITNAME ..... 


NIPCON ..... 
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IODEVICE Statement 


IODEVICE Statement 


Use IODEVICE statements to define the non-telecommunications devices, the 
telecommunications lines (this also defines the telecommunication terminals), and 
the telecommunication controllers in the I/O configuration. 


Rules for coding input statements are in “Coding Rules for Input Statements” on 
page 5-2. 


The parameter requirements for an IODEVICE statement vary according to the 
device. Therefore, before coding an IODEVICE statement refer to 

Chapter 6, “Defining I/O Devices” for specific device requirements. That 
chapter explains how to code an IODEVICE statement for each supported 
device. 


[name] IODEVICE ADDRESS = {device-number | 
(device-number,number-of-units)} 


s>CUNUMBR = (number|,number|...) 
s»UNIT = device-type 

| ADAPTER = adapter] 

| FEATURE = (feature|,feature]...)| 
|L.MODEL = model] 

IL. NUMSECT = {number}| 

|, OFFLINE = {YES|NO}] 

|,PATH = chpid| 

|,PCU =number| 

| SETADDR = {0[1|2]3}] 


| STADET = {Y|N}] 


[, TCU = {2701 |2702|2703}] 
|, TIMEOUT ={Y|N}] 
|,.UNITADD = unit-address| 





ADAPTER = adapter 
specifies either the terminal control or transmission adapter used to connect 
a telecommunications line to a transmission control unit, or the type of 
channel adapter that connects a 3704 or 3705 communications controller to 
a channel path. 
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IODEVICE Statement 


ADDRESS = {device-number|(device-number,number-of-units)} 
Specifies the initial device number and how many device numbers you want 
the MVS configuration program to assign. 


The variable device-number is the initial device number. 


The variable number-of-units (also called the replication factor) specifies 
how many device numbers you want the MVS configuration program to 
assign. 


device-number 


Specifies the device number. For most devices, you can specify a 
hexadecimal value in the range 000 through FFF. 


For some devices, there are limits on the values that you can specify 
for device-number. Before coding device-number for a device, see the 
IODEVICE statement description for that device in 

Chapter 6, “Defining I/O Devices.” That is where the limits are 
explained. 


e If you also code UNITADD= on the IODEVICE statement: 


— device-number can be any value that follows the rules, if any, 
for the device. 


— The sum of (device-number) plus (number-of-units - 1) must not 
exceed X‘FFF’. (Before doing this calculation, convert 
number-of-units to a hexadecimal value.) 


— UNITADD= must specify the device’s physical unit address. 
e If you do not code UNITADD= on the IODEVICE statement: 


— The two rightmost digits of the device-number must specify the 
device’s physical unit address. 


— The leftmost digit can be any hexadecimal value you choose. 


— The sum of (the two rightmost digits of device-number) plus 
(number-of-units - 1) must not exceed X‘FF’. (Before doing 
this calculation, convert number-of-units to a hexadecimal 
value.) 


Unless the device description in Chapter 6, “Defining I/O Devices” 
states otherwise, the MVS configuration program assigns device 
numbers in sequence starting with the device number you specify. For 
example: 


e If you code ADDRESS = (000) or ADDRESS =(000,1), the MVS 
configuration program assigns one device number, 000. 


e If you code ADDRESS =(000,4), the MVS configuration program 
assigns four device numbers, 000, 001, 002, and 003. 


Note: Do not specify the same device number for more than one 
device in an I/O configuration. 
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IODEVICE Statement 


number-of-units 
specifies how many device numbers the MVS configuration program is 
to assign. For a multiple exposure device, number-of-units specifies 
how many base exposures the MVS configuration program is to 
assign. You can specify a decimal number in the range 1 through 
4095. 


The MVS configuration program builds one UCB for each device 
number. For a multiple exposure device, this means one UCB for 
each exposure. 


If you omit number-of-units, the MVS configuration program usually 
uses the default value of 1. Exceptions are noted in the individual 
device descriptions in Chapter 6, “Defining I/O Devices” on 

page 6-1. 


IOCP assumes a number-of-units value of 1 for some devices. IBM, 
therefore, recommends that you explicitly specify number-of-units to 
avoid a possible conflict with the IOCP specification. See JOCP 
User's Guide and Reference. 


CUNUMBR = (number|,number]...) 
specifies the control unit number(s) of the control units to which the device 
is attached. The number(s) you specify must also be specified on the 
CUNUMBR= parameter of the CNTLUNIT statement. 


Specify 3 hexadecimal digits in the range 000 through FFF for each control 
unit. 


The, MVS configuration program does not use this parameter. For the 
IOCP the parameter is optional. For Information about IOCP’s use of this 
parameter, see JOCP User's Guide and Reference. 


FEATURE = (feature|,feature]...) 
Specifies the features available on the device. You may specify the features 
in any order. 


For information about the features that you can specify for a specific 
device, see the description for that device in Chapter 6, “Defining I/O 
Devices” on page 6-1. 


MODEL = model 
specifies the model number, if any, of the device. 


NUMSECT = {number} 
specifies the number of guaranteed 256-byte buffer sections in the 2840 
display-control buffer to be allocated to a 2250 Model 3. This parameter is 
valid for a 2250 Model 3 only. 


e If you omit the NUMSECT parameter, the available buffer space is 
divided equally among the 2250-3s. Any remaining buffer space is 
allocated to the last 2250-3 assigned. 


e If you code the NUMSECT parameter, the buffer space is allocated as 
you specify. You must ensure that each 2250-3 that is attached to the 
control unit has at least one buffer allocated. 
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IODEVICE Statement 


The total number of buffer sections guaranteed to the devices attached to a 
2840 must not exceed the number of sections in the buffer of that 2840. 


The device that you are specifying is the only device that can use these 
buffer sections. 


For help with selecting an appropriate value for this parameter, see: 
@ Introduction to the IBM 3250 Graphics Display System 


@ OS/VS Graphic Programming Support (GPS) for IBM 2250 Display 
Unit and IBM 3250 Graphics Display System 


OFFLINE = {YES|NO} 


specifies whether MVS is to consider the device online or offline at IPL. 
To specify the device as offline, code OFFLINE = YES. 


To specify the device as online, code OFFLINE=NO, or omit the 
parameter. 


If MVS needs the device during IPL, specify OFFLINE = NO 


PATH =chpid 


specifies the preferred channel path. The I/O subsystem uses the preferred 
channel path, if available, for the initiation of I/O operations. If the 
preferred path is busy or not available, any other available path will be 
used. 


The MVS configuration program does not use this parameter. The For 
IOCP the parameter is optional. For information about IOCP’s use of this 
parameter, see JOCP User’s Guide and Reference. 


PCU =number 


Identifies the 2240 model 2 control unit to which the 2250 model 3 is 
attached. The variable number may be any decimal value in the range 0 to 
4095. The operating system uses this number to identify the 2250-3s that 
are attached to a given 2240-2 control unit. 


Each 2240 can accept up to four 2250s. For a 2250-3 attached to a given 
control unit, you can specify any number in the range, 0 to 4095. For all 
2250-3s that are attached to that same control unit, you must specify the 
same number, however. Once you have used a number to identify 2250-3s 
attached to a particular 2240-2, do not use that same number to identify 
2250-3s that are attached to a different 2240-2. 


For example, assume your configuration includes two 2240-2 control units. 
For all of the 2250-3s attached to one of these control units, you could 
specify PCU=1. For all of the 2250-3s attached to the other control unit, 
you could specify PCU =2. 


Note: Do not code a separate IODEVICE statement for the 2240. That is, 
do not code an IODEVICE statement that specifies UNIT = 2240. 
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IODEVICE Statement 


SETADDR = {0]1[2]3} 
specifies which of the 4 set address (SAD) commands is to be issued to the 
transmission control unit (TCU) for operations on the line specified by the 
ADDRESS operand. 


Code SETADDR only if both of the following statements are true: 
@e The IODEVICE statement also specifies TCU =2702 


@ The device description in “Telecommunication Device Definitions” on 
page 6-70 tells you to code the SETADDR parameter 


If the TCU is a 2701 or 2703, the SETADDR parameter is ignored. 


STADET = {Y|N} 
specifies whether the illegal status detection facility is to be enabled or 
disabled in 370-XA mode. To enable the facility, specify Y; to disable it, 
specify N. 


In S/370 mode, the system ignores this facility. 


The MVS configuration program does not _use this parameter. For IOCP 
the parameter is optional. For information about IOCP’s use of this 
parameter, see JOCP User's Guide and Reference. 


TCU = {2701 |2702|2703} 
specifies the transmission control unit for a telecommunications line. 


If you code TCU =2702, you might also have to code the SETADDR 
parameter. To determine if you have to code the SETADDR parameter, see 
the description of the telecommunication device you are defining. The 
device description is in Chapter 6, “Defining I/O Devices” on page 6-1. 


Note: Do not code a separate IODEVICE statement for a 2701, 2702, or 
2703. That is, do not code an IODEVICE statement that specifies 
UNIT =2701, UNIT =2702, or UNIT = 2703. 


TIMEOUT = {Y|N} 
specifies whether the I/O interface timeout function is to be active for 
channel-initiated I/O operations to the device. If the timeout function is 
active and a timeout condition occurs, the channel subsystem terminates the 
I/O operation to the device and generates an interface-control-check 
interruption. 


Y 
specifies that the timeout function is to be active. When Y is 
specified, the channel times I/O operations. 


specifies that the timeout function is to be inactive (timeout 1s 
inhibited). The channel does not time I/O operations. 
The MVS configuration program does not use this parameter. For IOCP 


this parameter is optional. For information about IOCP’s use of this 
parameter, see JOCP User's Guide and Reference. 
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IODEVICE Statement 


UNIT = device-type 


specifies the device type. For telecommunication lines, specifies the device 
type that 1s connected to the line. 


When you define a device that the MVS configuration program supports, 
specify the device-type shown in the applicable device description in 
Chapter 6, “Defining I/O Devices” on page 6-1. 


To define an unsupported device as a DUMMY, specify UNIT = DUMMY. 


To define a device for which your installation has provided a unit 
information module (UIM), specify the device type required by the UIM 
design. For information about defining an unsupported device, see 
“Defining an Unsupported Device” on page 6-4. 


UNITADD = unit-address 


Required /Optional 


specifies the device’s physical unit address when the ADDRESS = parameter 
specifies a device number that does not include the physical unit address. 


The variable unit-address must be the device’s physical unit address and 
must be a hexadecimal value in the range X‘00’ to X‘FF’. 


For additional information about the UNITADD parameter, see [OCP 
User's Guide and Reference. 


This statement is required for each uniquely addressable device and 
telecommunications line you want included in the I/O configuration. If you omit 
the IODEVICE statement for a particular device or telecommunications line, the 
MVS configuration program does not include that device or line in the I/O 
configuration. 


Placement 


You can place these statements anywhere in the input stream. IBM recommends, 
however, that you place all IODEVICE statements together immediately after the 
last CNTLUNIT statement. 


Example 1 


This statement defines a 3277 Model 2 with a device number of 009. 


COO09 


IODEVICE UNIT=3277,ADDRESS=009 ,MODEL=2 
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IODEVICE Statement 


Example 2 


This statement defines a 2540 Model 1 card punch with the CARDIMAGE 
feature. The device number for the device is 00D. 


POOD IODEVICE UNIT=2540P,ADDRESS=OOD, 
FEATURE=CARDIMAGE ,MODEL=1 


Example 3 


This statement defines a 3350 with 6 drives. The MVS configuration program 
assigns six device numbers 130, 131, 132, 133, 134, and 135. 


D3350 IODEVICE UNIT=3350,ADDRESS=(130,6) 


Example 4 


This statement specifies a 3330 Model 1. The MVS configuration program 
assigns device numbers 290 and 291 (The 3330 defaults to two device numbers). 


IODEV IODEVICE UNIT=3330,MODEL=1,ADDRESS=290 


Example 5 


This statement specifies a 3350 attached to a 3880 Model 11 (also called a 3350P). 
The MVS configuration program assigns eight device numbers: the base device 
numbers are 2C4 and 2C5. The other assigned device numbers are 2CC, 2CD, 
2D4, 2D5, 2DC, and 2DD. 


PAGDS IODEVICE UNIT=3350P,ADDRESS=(2C4,2) 


Example 6 


This statement specifies a 3350 attached to a 3880 Model 21 (also called a 3351P). 
The MVS configuration program assign eight device numbers: the base device 
numbers are 2CO and 2C1. The other assigned device numbers are 2C4, 2CS, 
2C8, 2C9, 2CC, and 2CD. 


PAGST IODEVICE UNIT=3351P,ADDRESS=(2C0,2) 
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NIPCON Statement 


NIPCON Statement 


Use the NIPCON statement to identify devices that you will allow NIP to use as J 
consoles. If you wish, you can code multiple NIPCON statements. 


Rules for coding input statements are in “Coding Rules for Input Statements” on 
page 5-2. 





name 
A 1-to-8 character name. The MVS configuration program ignores this 
name. You may wish to code it, however, to help you identify your input 
statements. 


DEVNUM = (device-number|,device-number]...) 
The device-number of one or more devices that NIP can use as consoles. 
NIP tries to uses the devices in the order you list them, left-to-right. 


The variable device-number must be a hexadecimal value in the range 000 to 
FFF. This device number must also be specified on an IODEVICE 
statement or fall within the range of device numbers specified on an 
IODEVICE statement. 


If you specify only one device number, the parentheses are optional. 


Default: None J 


Devices That You Can Define as NIP Consoles 


The following chart lists devices that you can define as NIP consoles. 


Communications terminal - The 
terminal must have the CHECKING 
and OIU features and you must specify 
these features. 


Any device that can be defined as a 


3270-X. NIP uses this device as though 
it were a 3277-2. 


3277-2 Display station 
3278-2, -2A,- 3, - 4, or -5 Display station 


3279-2A, -2B, -2C, -3A, or Display station 
-3B 


Figure 5-1. Devices That You Can Define as NIP Consoles 
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Required /Optional 


Placement 


Example 


NIPCON Statement 


Notes: 


1. If you identify multiple devices as NIP consoles, MVS attempts to use them in 
the order they appear on the NIPCON statements. If you use multiple 
NIPCON statements, MVS attempts to use the devices listed on the first 
statement, then those listed on the second statement, and so forth. 


2. To ensure that all system messages appear on one console, IBM recommends 
that you identify the master console as the first console on the first NIPCON 
statement. 


3. All of the devices that you identify must be specified as being on-line: on the 
IODEVICE statement specify OFFLINE= NO or omit the OFFLINE 
parameter. 


This statement is required. You can include multiple NIPCON statements in the 
input stream. 


If you omit NIPCON statements from the input stream or you fail to specify one 
of the devices as being on-line, The MVS configuration program does a syntax 
check and a semantics check on the input stream and then terminates without 
building the I/O configuration. 


This statement may appear anywhere in the input stream. To provide an order to 
the input stream and to make it easier to read, however, IBM recommends that 
you place all NIPCON statements together at the end of the input stream. 


This example shows a partial input stream. The IODEVICE statements define 
devices that have device numbers 350, 421, and 450. The NIPCON statements 
identify these devices as consoles that NIP can use. 


In this example, assume that the installation has defined the 3270-X with the 
device number 450 as the master console. Therefore, to ensure that all system 
messages appear on one console, 450 should be the first device number specified 
on the first NIPCON statement. 


MVS attempts to use the devices in the order they are defined: 450, 350, and 421. 


IOCONFIG ID=BB 

IODEVICE ADDRESS=421,UNIT=3270,MODEL=X,..... 
IODEVICE ADDRESS=350,UNIT=3277,MODEL=1,..... 
IODEVICE ADDRESS=450,UNIT=3270,MODEL=X,..... 


EDT ID=01 
UNITNAME ..... 
UNITNAME ..... 


NIPCON DEVNUM=(450,350) 
NIPCON DEVNUM=421 
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UNITNAME Statement 


UNITNAME Statement 


Specification Rules 


Use the UNITNAME statement to: J 


Define an esoteric device group, assign the group a name, and indicate 
whether the group is to be eligible for VIO 


Identify generic device types that you want to be eligible for VIO 


Code UNITNAME statements according to the following rules: 


The device numbers specified must also be specified on an IODEVICE 
statement. 


If NAME = specifies a generic name, do not code the UNIT= parameter. 
You can specify VIO= YES only for: 


— An esoteric device group that contains at least one DASD 
— A generic device type that contains DASD 


Do not use a UNITNAME statement to assign a name to a group of 
telecommunication devices. If you do, when the assigned name is used on a 
DD statement, MVS will allocate only the first device specified on the 


UNIT = parameter. | J 


You can code a maximum of 255 characters in the operand field of a 
UNITNAME statement. If more device numbers must be listed than can fit 
on one statement, additional UNITNAME statements can be coded using the 
same variable in the NAME= parameter. Those UNITNAME statements 
with the same NAME= variable must be grouped contiguously in the input 
stream. If they are separated, the MVS configuration program assumes that 
the device numbers on the first UNITNAME statement are the only device 
numbers that belong to that device group. 


The MVS configuration program does not limit the number of esoteric device 
groups that you can define (the SYSGEN process limited you to 256). 


You do not have to assign esoteric names to devices that you define as 
UNIT=DUMMY. The MVS configuration program assigns these devices a 
generic name of DUMMY. Users can specify the generic nnme DUMMY for 
allocation purposes. 
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UNITNAME Statement 


Rules for coding input statements are in “Coding Rules for Input Statements” on 
page 5-2. 


UNITNAME | NAME= {esoteric-group-name | 
generic-name} 


[,UNIT = {device-number | 


(device-number 
|,device-number]...) | 


((device-number,n)) | 


((device-number,n) 
[,(device-number,n)}...)}] 


|, VIO = {YES|NO}] 





NAME = {esoteric-group-name|generic-name} 


@ When you define an esoteric device group, specify NAME = 
esoteric-group-name. The variable, esoteric-group-name is the name you 
want assigned to the group. The variable esoteric-group-name must be 
from | to 8 characters. These characters can be alphameric, national 
(#, @, or $), or the 2 special characters, slash (/) and hyphen (-). 


@e When you specify a generic device type, specify NAME = generic-name. 
The variable generic-name must be either an IBM-defined generic name 
listed in Appendix A, “Generic Device Types” on page A-l, or an 
installation-defined generic name. 


CAUTION 


e Do not specify NAME=SYSALLDA. This name is reserved for 
use by MVS only. 


e If the I/O configuration includes the Mass Storage 
Subsystem (MSS), the MSS Table Create Program 
generates UNITNAME statements. Be sure that the 
variables that you specify on NAME = are different than 
those generated by the MSS. 


For additional information about the MSS Table Create 
Program, see OS/VS Mass Storage Control Table Create. 
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UNITNAME Statement 


UNIT = 
specifies the device numbers of a group of I/O devices. The group can 
consist of one or more devices. The name you code on the NAME= 
parameter becomes the name of the group. 





Notes: 


Il. Code the UNIT= parameter only if the NAME= parameter specifies an 
esoteric group name. 


2. IBM recommends that all devices you assign to an esoteric device group 
be members of the same device class with the following exception: you 
may define a group that contains both DASD and magnetic tape devices. 


device-number 
specifies the device number of an I/O device. You can specify 3 
hexadecimal digits, 000 through FFF. 


The device number must also be defined on the ADDRESS = 
parameter of an IODEVICE statement. 


For a multiple exposure device (2305-2, 3350P or 3351P), 
device-number must be a base exposure. 


@ For a 2305-2, the base exposure 1s the device number that appears 
on the ADDRESS= parameter of the IODEVICE statement. 


@ For the 3350P or the 3351P, see Appendix C, “Determining } 
3350P and 3351P Device Number Assignments” on page C-1! for 
a list of base exposures. 


If you specify a non-base exposure, the MVS configuration program 
ignores the specification and issues an informational message, but 
otherwise, runs as though the non-base exposure had not been 
specified. 


((device-number,n)) 
specifies a sequence of consecutive device numbers. The variable 
device-number is the first device number in the sequence. The variable 
n, a 1- to 3-digit decimal number, indicates how many device numbers 
to include in the sequence. The default for 7 is 1. 


For example: 


e UNIT=((160,2)) specifies device numbers 160 and 161. This is 
equivalent to coding UNIT =(160,161) 


e UNIT =((200,4)) specifies device numbers 200, 201, 202, and 203. 
This is equivalent to coding UNIT =(200,201,202,203) 


Each of the device numbers in the sequence must also be defined on 
the ADDRESS= parameter of an IODEVICE statement. 
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Required/Optional 


UNITNAME Statement 


For a multiple exposure device (2305-2, 3350P or 3351P), the sequence 
of specified device numbers must include base exposures only. 


e For a 2305-2, the base exposure is the device number that appears 
on the ADDRESS= parameter of the IODEVICE statement. 


e For the 3350P or the 3351P, see Appendix C, “Determining 
3350P and 3351P Device Number Assignments” on page C-1 for 
a list of base exposures. 


If the sequence specifies a non-base exposure, the MVS configuration 
program ignores the specification and issues an informational message, 
but otherwise, works normally. 


You may mix the two forms of the UNIT parameter. If more than 
one value is expressed, the values must be enclosed in parentheses. If 
the form (device number, n) is used as the only subparameter on the 
statement, use double parentheses. For example, UNIT =((180,4)) 
specifies a group of 4 devices that have the device numbers 180, 181, 
182, and 183. 


Note: If you use the form UNIT = ((device-number,n)), be sure that 
the sum of (device-number) plus (n - 1) does not exceed X‘FFF’. (To 
do this calculation, you must convert n to a hexadecimal value.) 


VIO ={YES|NO} 
specifies whether or not you want this group of devices to be eligible for 
VIO. 


You can specify VIO= YES only for: 


e Anesoteric device group that contains at least one DASD 
e A generic device type that contains DASDs 


For information on VIO, see MV S/Extended Architecture System 
Programming Library: Initialization and Tuning. 


UNITNAME statements are required if: 


e You want to define esoteric device groups 
e You want to make devices eligible for VIO 


Note: The cataloged procedures that your installation uses determine which 
esoteric device groups you must define. For example, if you use certain 
procedures from the IBM-provided SYS1.PROCLIB, you will have to define 
esoteric device groups SYSDA and SYSSQ. To determine which esoteric device 
groups you must define, review your cataloged procedures. 
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UNITNAME Statement 


Placement 


Example 1 


Example 2 


Example 3 


Example 4 


If the input stream contains no EDT statement, IBM recommends that you place 
the UNITNAME statements immediately after the last IODEVICE statement. 


If the input stream contains one or more EDT statements, you must place the 
UNITNAME statements immediately after the EDT statement to which they 
correspond. 


This example defines an esoteric device group and names it TAPE. The group 
includes the devices that have device numbers 180, 181, 280, 281, and 282. 


UNITNAM1 UNITNAME NAME=TAPE, X 
UNIT=(180,181,280,281,282) 


This example defines an esoteric device group and names it DISK. The group 
includes the devices that have device numbers 130, 131, 132, 133, 134 135, 136, 
and 137. 


UNITNAM2 UNITNAME NAME=DISK, UNIT=((130,8) ) 


This example assigns the esoteric name 167 to an unsupported device. The 
unsupported device was assigned device number 167 (specified as 
UNIT = DUMMY,ADDRESS = 167 on an IODEVICE statement). 


UNITNAM3 UNITNAME NAME=167 , UNIT=167 


This example defined an esoteric device group and names it SYSDA. The group 
is eligible for VIO. 


UNITNAM4 UNITNAME NAME=SYSDA,VIO=YES, X 
UNITS (C1102) (15078) 30ers e5)y X 
(220,8),(250,8),(350,8) ,(410,8) ) 
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Chapter 6. Defining I/O Devices 


The MVS configuration program supports many IBM-built devices and several 
non-IBM devices. This book calls a device that the MVS configuration program 
supports a supported device. A device the MVS configuration program does not 
support is called an unsupported device. 


For each supported device, the MVS configuration program provides a program 
called a unit information module (UIM). It is the UIM that recognizes and 
processes the device’s IODEVICE statement. An unsupported device 1s one for 
which the MVS configuration program provides no UIM. 


Even though the MVS configuration program does not support a particular 
device, you can still define and use that device. How to do this is explained later 
in the topic “Defining an Unsupported Device” on page 6-4. Before you define 
any device, however, you must first determine if the MVS configuration program 
does or does not support the device. 


Locating Information in this Chapter 


This chapter contains the following major topics: 


Determining if The MVS Configuration Program Supports a Device 6-3 
Defining a Supported Device 6-4 
Defining an Unsupported Device 6-4 
Defining a DUMMY Device 6-4 
Writing a UIM to Support a Device 6-5 
Other Products May be Required 6-5 
Channel-to-Channel Adapter Definitions 6-6 
CTC Adapter or 3088 6-7 
DASD Definitions 6-8 
2305 Model 2 6-9 
3330 Model l or2 6-10 
3330 Model 11 = 6-11 
3333 Model 1 6-12 
3333 Model 11 6-13 


3340 = 6-14 
3344s 6-15 
3350 ~—s 6-16 


3350 (Attached to 3880-11) or 3350P 6-18 
3350 (Attached to a 3880-21) or 3351P 6-20 
3375 = 6-22 

3380 3 §=— 6-23 
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Display Device Definitions 6-24 
2250 Model 3 6-25 
3250 = 6-27 
3251 §=6-28 
3268 Model 2 Printer 6-29 
3270 Model X 6-30 
3274 Model 1A Control Unit 6-33 
3277 Model 1 or 2 Display Station 6-34 
3278 Model 1, 2, 2A, 3, 4, or 5 Display Station 6-37 
3279 Models S2B, S3G, 2A, 2B, 2C, 2X, 3A, 3B, and 3X _ ~— 6-40 
3284 Model | or 2 Printer for the 3277 6-43 
3286 Model 1 or 2 Printer for the 3277 6-44 
3287 Model 1, 1C, 2, or 2C Printer 6-45 
3288 Printer 6-46 
3289 Model 1 or 2 Printer 6-47 
3290 Information Panel 6-48 
5080 Graphics Device 6-49 
Magnetic Tape Device Definitions 6-50 
3420 Model 3, 5, or 7 Magnetic Tape Unit 6-51 
3420 Model 4, 6, or 8 Magnetic Tape Unit 6-53 
3430 Magnetic Tape Unit 6-54 
3480 Magnetic Tape Unit 6-55 
Miscellaneous I/O Device Definitions 6-57 
DUMMY Device 6-58 
1287 Optical Reader 6-59 
1288 Optical Page Reader 6-60 
3540 Diskette I/O Unit 6-61 
3838 Array Processor 6-62 
3848 Cryptographic Unit 6-63 
3886 Optical Character Reader 6-64 
3890 Document Processor 6-65 
3895 Document Reader/Inscriber 6-66 
MSS Device Definitions 6-67 
3330 Disk Storage Unit (Used as a Virtual Volume in an MSS) 6-68 
3851 Mass Storage Facility 6-69 
Telecommunication Device Definitions 6-70 
Defining Telecommunication Devices 6-70 
3704, 3705 Emulation Program Considerations 6-70 
Virtual Telecommunications Access Method (VTAM) Considerations 6-71 
BSC1, BSC2, and BSC3 6-72 
TWX (Teletype) Model 33 or 356-74 
WTTA (IBM World Trade Corporation Telegraph Terminal) 6-76 
1030 Data Collection System 6-77 
1050 Data Communications System 6-78 
1050X (1050 Data Communications System with Timeout Suppression) 6-80 
115A (Western Union Terminal) 6-82 
2740 Communication Terminal 6-83 
2740C (2740 Communication Terminal with Correspondence Code) 6-85 
2740X (2740 Communication Terminal with PTTC Code) 6-86 
2741C (2741 Communication Terminal with Correspondence Code) 6-88 
2741P (2741 Communication Terminal with PTTC Code) 6-89 
3274 Model 1A Control Unit 6-90 
3704 Communications Controller 6-91 
3705 Communications Controller 6-92 
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3725 Communications Controller 6-93 

3767 Communication Terminal 6-94 

3791L Controller 6-95 

7770 Audio Response Unit 6-96 

83B3 (AT&T Selective Calling Terminal) 6-97 
Unit Record Device Definitions 6-98 

1403 Model N1, 2, or 7 Printer 6-99 

2501 Model B1 or B2 Card Reader 6-100 

2540 Model 1 Card Read Punch 6-101 

3203 Model 5 Printer 6-102 

3211 Printer 6-103 

3262 Model 5 6-104 

3505 Card Reader 6-105 

3525 Card Punch 6-106 


3800 Model 1, 3, or 8 Printing Subsystem 6-107 
4245 Printer 6-108 
4248 Printer 6-109 


Determining if The MVS Configuration Program Supports a Device 


With the exception of telecommunication binary synchronous communication 
(BSC) terminals, all supported devices are listed in the index. To determine if the 
MVS configuration program supports a particular device, look for the device type 
in the index under the entry titled “Devices Supported,” or look in the index 
under the specific device type. If you find the device listed, the page reference 
refers you to the topic that explains how to code an IODEVICE statement for 
that particular device. 


If the index does not list the device type, the MVS configuration program does 
not support the device. To define an unsupported device, see the topic “Defining 
an Unsupported Device” on page 6-4. 


Note: The MVS configuration program supports all of the devices that the 
MVS/XA SYSGEN process supported except the 2260. 


The index does not list individual BSC terminals (a BSC terminal is any device 
that supports the BSC protocol). Instead, the index lists the type of 
communications line to which the BSC terminals attach. The types of 
communication lines are: 


@ switched point-to-point 
® nonswitched point-to-point 
@ nonswitched multipoint. 


The index entries for these line types direct you to the topic that explains how to 
code the IODEVICE statement that defines the line. By defining the line you also 
define the BSC terminals that are attached to the line. 


To determine if a particular device supports the BSC protocol, see the hardware 
manual for that device. 
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Defining a Supported Device 





To define a supported device, you need only code an IODEVICE statement. S 
There are several ways to find the topic that explains how to code the IODEVICE 
statement: 


@ Look in the index for the specific device type, such as 2250-3, 3350, or 4248. 
@ Look in the index under the entry titled “devices supported” 


@ Refer to the earlier topic in this chapter “Locating Information in this 
Chapter” on page 6-1. That topic defines where, in this chapter, the 
IODEVICE statements are described for the different device classes. Once 
you have located the device class within this chapter, the devices are listed in 
ascending alphanumerical order. 


Defining an Unsupported Device 


To define an unsupported device, do one of the following: 


@ Define the device asa DUMMY device 
@ Provide a UIM that supports the device 


Defining a DUMMY Device 


The MVS configuration program provides a UIM that recognizes any device that J 
you define as a DUMMY device. The MVS configuration program treats each 

DUMMY device as though it were a unit record device. That 1s, the MVS 

configuration program sets the UCBTYP field in the device’s UCB to 

X’00000800’. The MVS configuration program also assigns each DUMMY 

device a generic name of DUMMY and an error routine value of X’00’ (the 

system converts the value X’00’ to an error recovery program name, IGEO001C. 


Note: The MVS/XA SYSGEN process allowed you to define both the UCBTYP 
field and the error routine value. To do this, you coded the DEVTYPE 
parameter and the ERRTAB parameter on the IODEVICE statement. If these 
parameters appear on an IODEVICE statement in the MVS configuration 
program input stream, the MVS configuration program ignores them. 


To define a DUMMY device, all you need to do is code the appropriate 
IODEVICE statement. For specific information about coding this IODEVICE 
statement, see “DUMMY Device” on page 6-58. 


The following example shows an IODEVICE statement that defines a DUMMY 
device. 


IODEVICE UNIT =DUMMY,ADDRESS = 010,CUNUMBR=001 
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Cc 


Writing a UIM to Support a Device 


To define an unsupported device as a device type other than DUMMY, you must 
provide a UIM. You must also code an IODEVICE statement for the device. 


The UIM must recognize and process the IODEVICE statement that you code. 
The UIM design determines which parameters can be coded on the IODEVICE 
statement. 


IBM has provided a sample UIM in SYS1.SAMPLIB member SAMPUIM. You 
can modify this sample to create your own UIM. Detailed information about 
coding a UIM 1s in MVS/Extended Architecture System Programming Library: 
System Modifications. 


Other Products May be Required 


There are some devices that cannot be defined or used until an additional product 
is installed. The product must be installed on both the system where you define 
the device (that is the system where you run the MVS configuration program) and 
on the system where you use the device. For example, the 3851 and the 3330V 
cannot be defined or used unless you have MSS installed. 










Note: If you try to use an I/O configuration that includes one of these 
devices, and the system where you use the configuration does not include the 
required product, MVS will enter wait state during IPL processing. 


Devices that require additional products and the products they require are listed 
in the following table. For a list of each products FMID, see the program 
directory. 





















i287 
2250 
33300 
3540 
3848 
3886 
3890 
3895 
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Channel-to-Channel Adapter Definitions 


This topic explains how to code IODEVICE statements to define a 2 
channel-to-channel (CTC) adapter or a 3088. The documentation for each device 

starts on a new page and includes: 

@ Required parameters 

e Optional parameters 

@ Device features (if applicable) 

Devices are arranged in ascending alphanumerical order by device type. 

You must code one IODEVICE statement for each channel-to-channel attachment 

in your configuration. A channel-to-channel attachment is the addressable path 


through a CTC adapter or through a 3088 that connects your system to another 
system. 
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CTC Adapter or 3088 


Required Parameters 


Optional Parameters 


Device Features 





CTC Adapter or 3088 


e Code an IODEVICE statement for each channel-to-channel attachment in the 
configuration. 


e Do not connect multiple systems through multiple CTCs or multiple 3088s 
that are on the same channel path. With this type of a connection, channel 
path contention can cause a lockout condition. 


ADDRESS = {device-number|(device-number number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number[ number ]....) 
UNIT =CTC 





FEATURE =/feature (See “Device Features.’’) 
OFFLINE = {YES|NO} 

PATH = chpid 

STADET = {Y|N} 

TIMEOUT = {Y|N} 

UNITADD = nnn 





code this value 
on the parameter, 
To indicate the presence of this 
feature: FEATURE = 


The adapter or the 3088 
is attached to a System 370. 
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DASD Definitions 


This topic explains how to code IODEVICE statements for supported direct 2 
access storage devices. The documentation for each device starts on a new page 

and includes: 

e Required parameters 

e Optional parameters 

e Device features (if applicable) 

Devices are arranged in ascending numerical order by device type. The heading 


at the top of each page identifies the class of device, DASD, the device type, and 
model. 
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DASD 2305-2 


2305 Model 2 


The 2305-2 is a multiple exposure device. 


Required Parameters 


ADDRESS = (device-number,1) 
Notes: 


1. device-number must be a value in the range ‘000'X to 'FF8'X. 


2. The MVS configuration program assigns eight (8) consecutive device 
numbers starting with the device number you specify. The device number 


that you specify is called the 2305's base exposure. The other seven 
device numbers that the MVS configuration program assigns are called 
non-base exposures. Of the eight device numbers, the base exposure is 
the only one you can include on the UNIT= parameter of a 
UNITNAME statement. 


CUNUMBR = (number[ number J...) 
MODEL =2 
UNIT = 2305 





Optional Parameters 


FEATURE = (feature/ feature ]...) (See “Device Features’’) 
OFFLINE = {YES|NO} 

PATH = chpid 

STADET ={Y|N} 

TIMEOUT = {Y|N} 

UNITADD =nnn 





Device Features 


code this value 
on the parameter, 


To indicate the presence of this feature: FEATURE = 


DASD sharing and reserve/release 
logic usage: (Specify only one.) 


Share device with other SHARED 
systems; Use reserve/release 
logic as needed. 


Use reserve/release logic only SHAREDUP 
when the system is physically 
partitioned. 
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DASD 3330-1 or 2 


3330 Model 1 or 2 


Required Parameters 


Optional Parameters 


Device Features 


To define a 3330 as an MSS virtual volume (UNIT =3330V), see, “MSS Device 
Definitions” on page 6-67. 


ADDRESS = {device-number | (device-number,number-of-units)} 


Note: If you omit number-of-units, the MVS configuration program assigns 
two device numbers: the device number you specify and the next 
sequential device number. 


CUNUMBR = (number/ number ]...) 
UNIT = 3330 





FEATURE = (feature/ feature ]...) (See “Device Features.”) 
MODEL =1 


Notes: 


1. The default is model 1. 
2. You must define the model 2 as a model 1. 


OFFLINE = {YES|NO} 
PATH = chpid 
STADET = {Y|N} 
TIMEOUT ={Y|N} 
UNITADD = nan 





code this value 
on the parameter, 


To indicate the presence of this feature: FEATURE= 


There is a separate physical ALTCTRL 
control unit path to the device 


DASD sharing and reserve/release 
logic usage: (Specify only one.) 


Share device with other systems; Use SHARED 
reserve/release logic as needed. 


Use reserve/release logic only when the SHAREDUP 
system is physically partitioned. 
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DASD 3330-11 


3330 Model 11 


C 


Required Parameters 


ADDRESS = {device-number | (device-number,number-of-units)} 


Note: If you omit number-of-units, the MVS configuration program assigns 
two device numbers: the device number you specify and the next 
sequential device number. 


CUNUMBR = (number/[ number |...) 
MODEL =11 
UNIT = 3330 





Optional Parameters 


FEATURE = (feature/ feature ]...) (See “Device Features’) 


OFFLINE = {YES|NO} 
PATH = chpid 
STADET = {Y|N} 
TIMEOUT = {Y|N} 
UNITADD = nnn 





L Device Features 


code this value 
on the parameter, 
To indicate the presence of this 
feature: FEATURE= 


There is a separate physical ALTCTRL 
control unit path to the device 


DASD sharing and reserve/release 


logic usage: (Specify only one.) 


Share device with other 
systems; Use reserve/release 
logic as needed. 


Use reserve/release logic only SHAREDUP 
when the system is physically 
partitioned. 
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DASD 3333-1 


3333 Model 1 
The 3333-1 is functionally equivalent to the 3330-1. 


Required Parameters 


ADDRESS = {device-number | (device-number,number-of-units)} 


Note: If you omit number-of-units, the MVS configuration program assigns 
two device numbers: the device number you specify and the next 
sequential device number. 


CUNUMBR = (number[ number /...) 
UNIT = 3330 





Note: You must define the 3333 as a 3330. 


Optional Parameters 


FEATURE = (feature/ feature]...) (See “Device Features.”) 
MODEL =1 
Note: The default is model 1. 


OFFLINE = {YES|NO} 
PATH = chpid 
STADET = {Y|N} 
TIMEOUT ={Y|N} 
UNITADD = nnn 





Device Features 


code this value 
on the parameter, 


To indicate the presence of this feature: FEATURE = 


There is a separate physical ALTCTRL 
control unit path to the device 


DASD sharing and reserve/release 


logic usage: (Specify only one.) 


Share device with other 
systems; Use reserve/release 
logic as needed. 


Use reserve/release logic only SHAREDUP 
when the system is physically 
partitioned. 
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DASD 3333-11 


3333 Model 11 
C The 3333-11 is functionally equivalent to a 3330-11. 


Required Parameters 


ADDRESS = {device-number | (device-number,number-of-units)} 


Note: If you omit number-of-units, the MVS configuration program assigns 
two device numbers: the device number you specify and the next 
sequential device number. 


CUNUMBR = (number/[ number /...) 
MODEL = 11 
UNIT = 3330 


Note: You must define the 3333 as a 3330. 





Optional Parameters 


FEATURE = (feature/ feature ]...) (See “Device Features.”) 


OFFLINE = {YES|NO} 
PATH =chpid 
STADET = {Y|N} 
f TIMEOUT = {Y|N} 
\ UNITADD = nan 





Device Features 


code this value 
on the parameter, 
To indicate the presence of this 
feature: FEATURE = 


There is a separate physical ALTCTRL 
control unit path to the device. 


DASD sharing and reserve/release 


logic usage: (Specify only one.) 


Share device with other 
systems; Use reserve/release 
logic as needed. 


Use reserve/release logic only SHAREDUP 
when the system is physically 
partitioned. 
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DASD 3340 


3340 


Required Parameters 


Optional Parameters 


Device Features 





ADDRESS = {device-number | (device-number,number-of-units)} 


Note: If you omit number-of-units, the MVS configuration program assigns 
two device numbers: the device number you specify and the next 
sequential device number. 


CUNUMBR = (number[ number |...) 
UNIT = 3340 





FEATURE = (feature/ feature ]...) (See “Device Features.”’) 


OFFLINE = {YES|NO} 
PATH = chpid 
STADET = {¥|N} 
TIMEOUT = {Y|N} 
UNITADD = nnn 





code this value 
on the parameter, 


To indicate the presence of this feature: FEATURE = 


There is a separate physical ALTCTRL 
control unit path to the device. 


Rotational position sensing RPS 
(Required for 3340 
compatibility mode). 


DASD sharing and reserve/release 
logic usage: (Specify only one.) 


Share device with other SHARED 
systems; Use reserve/release 
logic as needed. 


Use reserve/release logic only SHAREDUP 
when the system is physically 
partitioned. 
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3344 


Required Parameters 


Optional Parameters 


Device Features 





DASD 3344 


The 3344 is functionally equivalent to four IBM 3340s mounted with a 3348 
Model 70 head disk assembly. Each 3344 has two drives and requires eight 
logical addresses. For information on addressing requirements, see the 
appropriate control unit manual. 


Code an IODEVICE statement for each 3340 that is to be simulated by the 3344. 


ADDRESS = {device-number | (device-number,number-of-units)} 


Note: If you omit number-of-units, the MVS configuration program assigns 
two device numbers: the device number you specify and the next 
sequential device number. 


CUNUMBR = (number[ number |...) 
UNIT = 3340 


Note: You must define the 3344 as a 3340. 





FEATURE = (feature/ feature/]...) (See “Device Features.”’) 


OFFLINE = {YES|NO} 
PATH = chpid 
STADET = {Y|N} 
TIMEOUT = {Y|N} 
UNITADD = nnn 





code this value 
on the parameter, 


To indicate the presence of this feature: FEATURE = 


There is a separate physical ALTCTRL 
control unit path to the device. 


Rotational position sensing (Required RPS 
for 3340 compatibility mode). 


DASD sharing and reserve/release 
logic usage: (Specify only one.) 


Share device with other systems; Use SHARED 
reserve/release logic as needed. 


Use reserve/release logic only when SHAREDUP 
the system is physically partitioned. 
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DASD 3350 


3350 
You can use the 3350 in either of two modes: } 


@ 3350 native mode (the 3350 functions as a 3350) 
@ 3330 compatibility mode (the 3350 functions as either a 3330-1 or a 3330-11) 


The topic you are reading explains how to code the IODEVICE statement so you 
can use the 3350 in native mode. 


To use the 3350 in compatibility mode, code the IODEVICE statement as you 
would for either a 3330-1 or a 3330-11. For information on how to code these 
IODEVICE statements, see the appropriate topic: 


@ “3330 Model | or 2” on page 6-10 
@ “3330 Model 11” on page 6-11 


For additional information about 3330 compatibility mode, see 3350/3344 
Installation and Conversion Guide. 


Required Parameters 


ADDRESS = {device-number | (device-number,number-of-units)} 


Note: If you omit number-of-units, the MVS configuration program assigns 
two device numbers. the device number you specify and the next 


sequential device number. ) 
CUNUMBR = (number number J...) . 


UNIT = 3350 





Optional Parameters 


FEATURE = (feature/ feature]...) (See “Device Features” on page 6-17.) 
OFFLINE = {YES|NO} 
PATH = chpid 


STADET = {Y|N} 
TIMEOUT = {Y|N} 
UNITADD = nnn 
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DASD 3350 


Device Features 


Cc code this value 


on the parameter, 
To indicate the presence of this 
feature: FEATURE = 


There is a separate physical . ALTCTRL 
control unit path to the device. 


DASD sharing and reserve/release 


logic usage: (Specify only one.) 


Share device with other SHARED 
systems; Use reserve/release 
logic as needed. 


Use reserve/release logic only SHAREDUP 
when the system is physically 
partitioned. 
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DASD 3350 (Attached to 3880-11) or 3350P 


3350 (Attached to 3880-11) or 3350P 


Required Parameters 


A 3350 that is attached to a 3880-11 is called a 3350P. ; 


When a user or programmer must specify device type, such as on a DD 
statement UNIT = parameter, they must specify the device type as 3350, not 
as 3350P. When you define the device on the IODEVICE statement, 
however, you must specify UNIT = 3350P. 


The 3350P is a multiple exposure device. 


ADDRESS = {device-number | (device-number,number-of-units)} 


Note: The variable device-number must be a 3-digit hexadecimal value in 
the range 000 to FE6. The variable number-of-units (also called the 
replication factor) must be a decimal value in the range | to 8 or may be 
omitted. If you omit number-of-units or specify 1, the MVS configuration 
program uses a default value of 2. 


In order to explain the rules for coding the ADDRESS= parameter, the 
symbols xyz will represent the three digits of the device address and the 
symbol r will represent the number-of-units or replication factor. Using 
these symbols the ADDRESS= parameter can be shown as 
ADDRESS = (xyz,r). The ADDRESS= parameter must adhere to the 


following rules: 
x (the leftmost digit) must be in the range 0 to F. J 
y (the middle digit) must be even (0,2,4,6,8,A,C, or E). 
z (the rightmost digit) must be less than 7 (0 to 6). 
The sum of z + r must be less than 9 (z + r < 9). For this 


calculation, if you omit number-of-units or code a value of 1, use a 
value of 2 for r. 
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DASD 3350 (Attached to 3880-11) or 3350P 


The variable number-of-units determines how many device numbers the MVS 
configuration program assigns (it always assigns a minimum of eight). The 
MVS configuration program first assigns the device number you specify. It 
then uses that number as a base to calculate the additional device numbers 
that it assigns. The following chart shows, for different values of 
number-of-units, how many device numbers the MVS configuration program 
assigns. 


If number-of-units 1s: The number of device numbers assigned is: 


omitted, 1, or 2 8 
12 
16 
20 
24 
28 
32 


The actual values of the device numbers the MVS configuration program 
assigns depends on the value of the device number you specify. You must be 
aware of the assigned device numbers so you do not assign them to another 
device. For more information about the device numbers that the MVS 
configuration program assigns and the maximum allowable values for 
number-of-units, see Appendix C, “Determining 3350P and 3351P Device 
Number Assignments” on page C-l1. 


The only device numbers that you can code on the UNIT= parameter of a 
UNITNAME statement are the base exposures. 


CUNUMBR = (number{[ number /...) 
UNIT =3350P 





Optional Parameters 


OFFLINE = {YES/NO} 
PATH = chpid 
STADET = {Y|N} 


TIMEOUT = {Y|N} 
UNITADD = nnn 





Device Features 


None Supported. 


Chapter 6. Defining I/O Devices 6-19 


DASD 3350 (Attached to a 3880-21) or 3351P 


3350 (Attached to a 3880-21) or 3351P 


Required Parameters 


A 3350 that is attached to a 3880-21 is called a 3351P. 


When a user or programmer must specify device type, such as on a DD 
statement UNIT= parameter, they must specify the device type as 3350, not 
as 3351P. When you define the device on an IODEVICE statement, however, 
you must specify UNIT =3351P. 


The 3351P is a multiple exposure device. 


ADDRESS = {device-number | (device-number,number-of-units)} 


Note: The variable device-number must be a 3-digit hexadecimal value in 
the range 000 to FF2. The variable number-of-units (also called the 
replication factor) must be a decimal value in the range | to 4 or may be 
omitted. If you omit number-of-units or specify 1, the MVS configuration 
program uses a default value of 2. 


In order to explain the rules for coding the ADDRESS= parameter, the 
symbols xyz will represent the three digits of the device address and the 
symbol r will represent the number-of-units or replication factor. Using 
these symbols the ADDRESS= parameter can be shown as 

ADDRESS = (xyz,r). The ADDRESS= parameter must adhere to the 
following rules: 


x (the leftmost digit) must be in the range 0 to F. 


y (the middle digit) must be in the range 0 to F. 


z (the rightmost digit) must be less than 3 (0 to 2). 


The sum of z + r must be less than 5 (z + r < 5). For this 
calculation, if you omit number-of-units or code a value of 1, use a 
value of 2 for r. 
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Optional Parameters 


Device Features 


DASD 3350 (Attached to a 3880-21) or 3351P 





The variable number-of-units determines how many device numbers the MVS 
configuration program assigns (It always assigns a minimum of eight). The 
MVS configuration program first assigns the device number you specify. The 
MVS configuration program then uses that number as a base to calculate the 
additional device numbers that it assigns. The following chart shows, for 
different values of number-of-units, how many device numbers the MVS 
configuration program assigns. 










If number-of-units is: The number of device numbers assigned is: 









omitted, 1, or 2 8 
3 12 
4 16 
















The actual values of the device numbers the MVS configuration program 
assigns depends on the value of the device number you specify. You must be 
aware of the assigned device numbers so you do not assign them to another 
device. For more information about the device numbers that the MVS 
configuration program assigns and the maximum allowable values for 
number-of-units, see Appendix C, “Determining 3350P and 3351P Device 
Number Assignments” on page C-1. 


The only device numbers that you can code on the UNIT= parameter of a 
UNITNAME statement are the base exposures. 





CUNUMBR = (number|[ number }...) 
UNIT = 3351P 


OFFLINE = {YES|NO} 
PATH = chpid 
STADET = {Y|N} 


TIMEOUT ={Y|N} 
UNITADD = nnn 





None Supported. 
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DASD 3375 


3375 


Required Parameters 


Optional Parameters 


Device Features 





ADDRESS = {device-number | (device-number,number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number/ number /...) 
UNIT = 3375 





FEATURE = (feature/ feature ]...) (See “Device Features.”) 


OFFLINE = {YES|NO} 
PATH = chpid 
STADET = {Y¥|N} 
TIMEOUT ={¥Y|N} 
UNITADD = nnn 





A 
code this value 3 


on the parameter, 
To indicate the presence of this 
feature: FEATURE= 


There is a separate physical ALTCTRL 
control unit path to the device. 


DASD sharing and reserve/release 


logic usage: (Specify only one.) 


Share device with other SHARED 
systems; Use reserve/release 
logic as needed. 


Use reserve/release logic only SHAREDUP 
when the system is physically 
partitioned. 
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C 


3380 


Required Parameters 


Optional Parameters 


Device Features 


ADDRESS = {device-number |(device-number number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number number J...) 
UNIT = 3380 


FEATURE = (feature/ feature ]...) (See “Device Features.”) 


OFFLINE = {YES|NO} 
PATH = chpid 
STADET={Y|N} 
TIMEOUT = {Y|N} 
UNITADD =nnn 


DASD 3380 








code this value 
on the parameter, 


To indicate the presence of this 


feature: FEATURE = 


There is a separate physical ALTCTRL 


control unit path to the device. 


DASD sharing and reserve/release 


logic usage: (Specify only one.) 


Share device with other SHARED 


systems; Use reserve/release 
logic as needed. 


Use reserve/release logic only SHAREDUP 


when the system is physically 
partitioned. 
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Display Device Definitions 


This topic explains how to code IODEVICE statements for supported display J 
devices. The documentation for each device starts on a new page and includes: 


@ Required parameters 

e Optional parameters 

e Device features (if applicable) 

Devices are arranged in ascending numerical order by device type. The heading 


at the top of each page identifies the class of device, display device, the device 
type, and model. 


6-24 MVS/XA MVS Configuration Program Guide and Reference 


C 


2250 Model 3 


Required Parameters 


Display Device 2250-3 


The system on which you run the MVS configuration program to define the 
2250-3, and the system on which you use the 2250-3 must both have Graphics 
Access Method/SP2 (GAM/SP2) installed. 


For more information about required products, see “Other Products May be 
Required” on page 6-5. 


For information that will help you select appropriate values for the parameters 
NUMSECT, and PCU, see the following books: 


@ Introduction to the IBM 3250 Graphics Display System 


@ OS/VS Graphic Programming Support (GPS) for IBM 2250 Display Unit and 
IBM 3250 Graphics Display System 


ADDRESS = {device-number|(device-number,number-of-units)} 
Notes: 
I. The default for number-of-units is 1. 


2. Do not assign this 2250 a device number that is within the range of 


device numbers of a 2250 that is attached to a different 2840 model 2 
control unit. 


CUNUMBR = (number[ number /....) 
MODEL =3 

PCU =number 

UNIT = 2250 





(Continued on next page) 
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Display Device 2250-3 


Optional Parameters 


FEATURE = (feature/ feature ]..) (See “Device Features”) 
NUMSECT = number 
OFFLINE = {YES|NO} 


PATH = chpid 
STADET = {Y|N} 
TIMEOUT = {Y|N} 
UNITADD =nnn 


Device Features 


To indicate the presence of this 
feature: 


Alphameric keyboard (Required if 
if you use the 2250 as an 
operator’s console) 


Programmed function keyboard 
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code this value 
on the parameter, 


FEATURE = 


ALKYB2250 


PRGMKYBD 





3250 


Required Parameters 


Optional Parameters 


Device Features 


Display Device 3250 


The 3250 is functionally equivalent to a 2250-3 that is attached to a 2840-2. 


ADDRESS = {device-number|(device-number,number-of-units)} 


Note: The default for number-of-units 1s 1. 


CUNUMBR = (number/ number /...) 
MODEL =3 

*PCU =number 
UNIT = 2250 





Note: You must define the 3250 as a 2250 model 3. 


FEATURE = (feature/ feature]...) (See “Device Features.”) 
NUMSECT = number 

OFFLINE = {YES|NO} 

PATH = chpid 

STADET = {Y|N} 

TIMEOUT = {Y|N} 

UNITADD =nnn 









code this value 
on the parameter, 
To indicate the presence of this 
feature: FEATURE= 


Alphameric keyboard ALKYB2250 


Programmed function keyboard PRGMKYBD 
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Display Device 3251 


3251 
The 3251 is functionally equivalent to a 2250 model 3. Therefore, you must a 


define the 3251 as though it were a 2250 model 3. For instructions on how to 
code the IODEVICE statement, see “2250 Model 3” on page 6-25. 
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L 


3268 Model 2 Printer 


Required Parameters 


Optional Parameters 


Device Features 


Display Device 3268-2 


ADDRESS = {device-number|(device-number number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number number ]...) 
MODEL =2 
UNIT = 3286 


Note: You must define the 3268 model 2 as a 3286 model 2. 





FEATURE = (feature/ feature ]...) (See “Device Features.”) 


OFFLINE = {YES|NO} 
PATH = chpid 
STADET ={Y|N} 
TIMEOUT ={Y|N} 
UNITADD = nnn 


To indicate the presence of this 
feature: 


Character generator (Select only one) 
United States English (default) 
French 
German 
Katakana 


United Kingdom 


The 3268 is attached 

to a 3274-D control unit. 
This feature may improve 
the performance of the 3268 
if programs that access the 
device use the appropriate 
channel programs. 








code this value 
on the parameter, 


FEATURE = 


DOCHAR 
FRCHAR 

GRCHAR 
KACHAR 
UKCHAR 


PTREAD 
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Display Device 3270-X 


3270 Model X 


Required Parameters 


Optional Parameters 


A 3270-X device is any device that has been defined on an IODEVICE statement 
as a 3270 Model X. 


You can define any of the following as a 3270-X: 
@ 3278-2, -3, -4, or -5 

@ = 3279-S2B, -S3G, -2B, -2X, -3B, or -3X 

e 3290 


e Any device that supports the 3270 data stream and one of the following 
screen sizes. Screen size is shown as (row X column). 


24 X 80 31 X 160 50 X 106 
27 X 132 32 X 80 62 X 80 
31 X 80 43 X 80 62 X 160 


The control unit to which the device is attached must be at a customization 
level that permits MVS to query the device. If MVS cannot query the device 
or cannot determine the actual device type, MVS treats the device as a 
3277-2. 


Any 3270-X device can be physically replaced by another 3270-X device without 
the need to change the I/O configuration definition (IODEVICE statement). 


ADDRESS = {device-number|(device-number number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number [ number /...) 
MODEL =X 
UNIT = 3270 





FEATURE = (feature/ feature]...) (See “Device Features” on 
page 6-31) 
OFFLINE = {YES|NQO} 


PATH = chpid 
STADET = {¥|N} 
TIMEOUT = {Y|N} 
UNITADD = nnn 
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J 


Device Features 


To indicate the presence of this 
feature: 


Character generator (Select only one) 


ASCIT A 
ASCII B 


United States English (default) 


French 

German 
Katakana 
United Kingdom 


Audible alarm (Requires a 
keyboard) 


Magnetic card reader adapter 
Numeric lock 


The 3270-X is attached 

to a 3274-D control unit. 

This feature may improve 

the performance of the 3270-X 
if programs that access the 
device use the appropriate 
channel programs. 


Selector pen (light pen) 


Keyboard type (Select only one) 
ASCII typewriter 
EBCDIC data entry 
EBCDIC typewriter 
78-key operator console 


Keyboard size (Select only one) 
70-key 
78-key 
81-key 





Display Device 3270-X 


code this value 
on the parameter, 


FEATURE = 


ASCACHAR 
ASCBCHAR 
DOCHAR 
FRCHAR 
GRCHAR 
KACHAR 
UKCHAR 


AUDALRM 


MAGCDRD 
NUMLOCK 


PTREAD 


SELPEN 


ASKY3277 
DEKY3277 
EBKY3277 
OCKY3277 


KB70KEY 
KB78KEY 
KB81KEY 


Required parameter combinations are shown in the next chart. 


(Continued on next page) 
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Display Device 3270-X 


Required Parameter Combinations 






If you specify you must also specify: 

KACHAR EBKY3277 and KB81KEY or 
DEKY3277 and KB70KEY 

KB70KEY DEKY3277 and KACHAR 


KB78KEY ASKY3277 or EBKY3277 or OCKY3277 
KB81KEY EBKY3277 and KACHAR 


AUDALRM ASKY3277 or DEKY3277 or EBKY3277 or 
OCKY3277 
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C 


Display Device 3274-1A 


3274 Model 1A Control Unit 


l. 


If each device that is attached to the 3274-1A has its own device number, do 
not code an IODEVICE statement for the 3274-1A. You must, instead, code 
an IODEVICE statement for each of the attached devices. For instructions 
on how to c8de the IODEVICE statements, see the appropriate device 
description in this chapter. 


If the 3274-1A is locally attached and it has systems network architecture 
(SNA) support that permits the control of multiple devices through one device 
number, you must code an IODEVICE statement for the 3274-1A. Do not 
code IODEVICE statements for any of the devices attached to the 3274-1A. 


You must define the 3274-1A as though it were a 3791L. For instructions on 
how to code the IODEVICE statement, see “3791L Controller” on page 6-95. 
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Display Device 3277-1 or 2 


3277 Model 1 or 2 Display Station 


Required Parameters 


Optional Parameters 


ADDRESS = {device-number|(device-number ,number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number/[ number |...) 
MODEL = {1]2} 
UNIT = 3277 












FEATURE = (feature/ feature ]...) (See “Device Features” on 
page 6-35) 

OFFLINE = {YES|NO} 
PATH =chpid 
STADET={Y|N} 
TIMEOUT ={Y|N} 
UNITADD =nnn 
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Device Features 


To indicate the presence of this 
feature: 


Character generator (Select only one) 


ASCII A 
ASCII B 


United States English (default) 


French 

German 
Katakana 
United Kingdom 


Audible alarm (Requires a 
keyboard) 


Magnetic card reader adapter 
Numeric lock 


The 3277 is attached 

to a 3274-D control unit. 
This feature may improve 
the performance of the 3277 
if programs that access the 
device use the appropriate 
channel programs. 


Selector pen (light pen) 


Keyboard type (Select only one) 
ASCII typewriter 
EBCDIC data entry 
EBCDIC typewriter 
78-key operator console 


Keyboard size (Select only one) 
70-key 
78-key 
81-key 





Display Device 3277-1 or 2 


code this value 
on the parameter, 


FEATURE= 


ASCACHAR 
ASCBCHAR 
DOCHAR 
FRCHAR 
GRCHAR 
KACHAR 
UKCHAR 


AUDALRM 


MAGCDRD 
NUMLOCK 


PTREAD 


SELPEN 


ASK Y3277 
DEKY3277 
EBKY3277 
OCKY3277 


KB70KEY 
KB78KEY 
KB81KEY 


Required parameter combinations are shown in the next chart. 


(Continued on next page) 
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Display Device 3277-1 or 2 


Required Parameter Combinations 


If you specify you must also specify: 
KACHAR EBKY3277 and KB81KEY or 
DEK Y3277 and KB70KEY 


KB70KEY DEK Y3277 and KACHAR 


KB78KEY ASKY3277 or EBKY3277 or OCKY3277 
KB81KEY EBKY3277 and KACHAR 


AUDALRM ASKY3277 or DEKY3277 or EBKY3277 or 
OCKY3277 
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Display Device 3278-1, 2, 2A, 3, 4, or 5 


3278 Model 1, 2, 2A, 3, 4, or 5 Display Station 

( You can define models 2, 2A, 3, or 4 as either a 3278 or a 3270-X. 
You must define a model 5 as a 3270-X. 
Any 3270-X device (a 3270-X device is any device that has been defined on an 
IODEVICE statement as a 3270 Model X) can be physically replaced by another 
3270-X device without the need to change the I/O configuration definition 
(IODEVICE statement). “3270 Model X” on page 6-30 explains how to define a 
device as a 3270-X. 
The remainder of this topic explains how to define a 3278 as a 3278. 


Required Parameters 


ADDRESS = {device-number |(device-number number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number/[ number |...) 
MODEL = {1]2|2A|3]4} 
UNIT = 3278 





Optional Parameters 


FEATURE = (/eature/ feature ]...) (See “Device Features” on 
page 6-38) 

OFFLINE = {YES|NO} 

PATH = chpid 

STADET = {Y|N} 

TIMEOUT =({Y|N} 

UNITADD = nnn 








(Continued on next page) 
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Device Features 


Display Device 3278-1, 2, 2A, 3, 4, or 5 


To indicate the presence of this 
feature: 


Character generator (Select only one) 
ASCII A 
ASCII B 
United States English (default) 
French 
German 
Katakana 
United Kingdom 


Audible alarm (Requires a 
keyboard) 


Magnetic card reader adapter 
Numeric lock 


The 3278 is attached 

to a 3274-D control unit. 
This feature may improve 
the performance of the 3278 
if programs that access the 
device use the appropriate 
channel programs. 


Selector pen (light pen) 


Keyboard type (Select only one) 
ASCII typewriter 
EBCDIC data entry 
EBCDIC typewriter 
78-key operator console 


Keyboard size (Select only one) 
70-key 
78-key 
81-key 





code this value 2 


on the parameter, 


FEATURE = 


ASCACHAR 
ASCBCHAR 
DOCHAR 
FRCHAR 
GRCHAR 
KACHAR 
UKCHAR 


AUDALRM 


MAGCDRD 
NUMLOCK 


PTREAD 


SELPEN 


ASK Y3277 
DEKY3277 
EBKY3277 
OCKY3277 


KB70KEY 
KB78KEY 
KB81KEY 


Required parameter combinations are shown in the next chart. 
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Display Device 3278-1, 2, 2A, 3, 4, or 5 


Required Parameter Combinations 


C 










If you specify you must also specify: 

KACHAR EBKY3277 and KB81KEY or 
DEKY3277 and KB70KEY 

KB70KEY | DEKY3277 and KACHAR 


KB78KEY ASKY3277 or EBKY3277 or OCKY3277 
KB81KEY EBKY3277 and KACHAR 


AUDALRM ASKY3277 or DEK Y3277 or EBK Y3277 or 
OCKY3277 
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Display Device 3279-S2B, S3G, 2A, 2B, 2C, 2X, 3A, 3B, and 3X 


3279 Models S2B, S3G, 2A, 2B, 2C, 2X, 3A, 3B, and 3X 
You can define models 2B or 3B as either a 3279 or a 3270-X. ) 
You can define the following models only as a 3270-X: S2B, S3G, 2X, and 3X. 
Any 3270-X device (a 3270-X device is any device that has been defined on an 
IODEVICE statement as a 3270 Model X) can be physically replaced by another 
3270-X device without the need to change the I/O configuration definition 
(IODEVICE statement). “3270 Model X” on page 6-30 explains how to define a 
device as a 3270-X. 
The reminder of this topic explains how to define a 3279 as a 3279. 


Required Parameters 


ADDRESS = {device-number|(device-number number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number number /...) 
MODEL = {2A|2B|2C|3A|3B} 
UNIT =3279 





Optional Parameters 


FEATURE = (feature/ feature ]...) (See “Device Features” on 
page 6-41) 

OFFLINE = {YES|NO} 
PATH =chpid 

| STADET = {Y|N} 
TIMEOUT = {¥Y|N} 
UNITADD =nnn 
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Display Device 3279-S2B, S3G, 2A, 2B, 2C, 2X, 3A, 3B, and 3X 


Device Features 


‘Se code this value 


on the parameter, 
To indicate the presence of this 
feature: FEATURE = 


Character generator (Select only one) 
ASCII A ASCACHAR 
ASCII B ASCBCHAR 
United States English (default) DOCHAR 
French FRCHAR 
German GRCHAR 
Katakana ~ KACHAR 
United Kingdom UKCHAR 


Audible alarm (Requires a AUDALRM 
keyboard) 


Magnetic card reader adapter MAGCDRD 
Numeric lock NUMLOCK 


The 3279 is attached PTREAD 
to a 3274-D control unit. 
This feature may improve 
Se the performance of the 3279 
if programs that access the 
device use the appropriate 
channel programs. 


Selector pen (light pen) SELPEN 


Keyboard type (Select only one) 
ASCII typewriter ASKY3277 
EBCDIC data entry DEKY3277 
EBCDIC typewriter EBKY3277 
78-key operator console OCKY3277 


Keyboard size (Select only one) 
70-key KB70KEY 
78-key KB78KEY 
81-key KB81KEY 





Required parameter combinations are shown in the next chart. 


(Continued on next page) 
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Display Device 3279-S2B, S3G, 2A, 2B, 2C, 2X, 3A, 3B, and 3X 


Required Parameter Combinations 





If you specify you must also specify: 

KACHAR EBKY3277 and KB81KEY or 
DEK Y3277 and KB70KEY 

KB70KEY DEK Y3277 and KACHAR 


KB78KEY ASKY3277 or EBKY3277 or OCKY3277 
KB81 KEY EBKY3277 and KACHAR 


AUDALRM ASKY3277 or DEK Y3277 or EBKY3277 or 
OCKY3277 
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Display Device 3284-1 or 2 


3284 Model 1 or 2 Printer for the 3277 


C 


Required Parameters 


ADDRESS = {device-number |(device-number number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number[ number |...) 
MODEL = {12} 
UNIT = 3284 





Optional Parameters 


FEATURE = (feature/ feature ]...) (See “Device Features.”) 
OFFLINE = {YES|NO} 

PATH = chpid 

STADET = {Y|N} 

TIMEOUT = {Y|N} 

UNITADD =nnn 





Device Features 


S code this value 


on the parameter, 


To indicate the presence of this 
feature: FEATURE = 


Character generator (Select only one) 
United States English (default) DOCHAR 
French FRCHAR 
German GRCHAR 
Katakana KACHAR 


United Kingdom UKCHAR 


The 3284 1s attached PTREAD 
to a 3274-D control unit. 

This feature may improve 

the performance of the 3284 

if programs that access the 

device use the appropriate 

channel programs. 
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Display Device 3286-1 or 2 


3286 Model 1 or 2 Printer for the 3277 


Required Parameters 


Optional Parameters 


Device Features 


ADDRESS = {device-number|(device-number number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number[ number /...) 
MODEL = {1[2} 
UNIT = 3286 








FEATURE = (feature/ feature ]...) (See “Device Features.”) 
OFFLINE = {YES|NO} 

PATH = chpid 

STADET = {Y|N} 

TIMEOUT = {Y|N} 

UNITADD =nnn 







code this value 
on the parameter, 
To indicate the presence of this 
feature: FEATURE = 


Character generator (Select only one) 
United States English (default) DOCHAR 
French FRCHAR 
German GRCHAR 
Katakana KACHAR 


United Kingdom UKCHAR 


The 3286 is attached PTREAD 
to a 3274-D control unit. 

This feature may improve 

the performance of the 3286 

if programs that access the 

device use the appropriate 

channel programs. 
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Display Device 3287-1, 1C, 2, or 2C 


3287 Model 1, 1C, 2, or 2C Printer 


Required Parameters 


Optional Parameters 


Device Features 


You must define this device as either a 3284 or a 3286. If you plan to use this 
device as an operator’s console, IBM recommends that you define it as a 3286-2 
(UNIT = 3286,MODEL = 2). 


You must specify: 


e The Model 1C asa Model 1 
@ The Model 2C as a Model 2 


ADDRESS = {device-number|(device-number number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number[ number ]...) 
MODEL = {12} 
UNIT = {3284|3286} 





FEATURE = (feature/ feature ]...) (See “Device Features.”) 
OFFLINE = {YES|NO} 

PATH = chpid 

STADET ={Y|N} 

TIMEOUT = {Y|N} 

UNITADD =nnn 





code this value 
on the parameter, 


To indicate the presence of this feature: FEATURE = 


Character generator (Select only one) 
United States English (default) DOCHAR 
French FRCHAR 
German GRCHAR 


Katakana KACHAR 
United Kingdom UKCHAR 


The 3287 is attached to a 3274-D control PTREAD 
unit. This feature may improve the 

performance of the 3287 if programs 

that access the device use the 

the appropriate channel programs. 
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Display Device 3288 


3288 Printer 
You must define this device as either a 3284 or a 3286. If you plan to use this ) 
device as an operator’s console, IBM recommends that you define it as a 3286-2 


(UNIT = 3286, Model = 2). 


Required Parameters 


ADDRESS = { device-number|(device-number ,number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number[ number /...) 
MODEL = {12} 
UNIT = {3284/3286} 





Optional Parameters 


FEATURE = (feature/ feature ]...) (See “Device Features.”’) 
OFFLINE = {YES|NO} 

PATH = chpid 

STADET = {Y|N} 

TIMEOUT ={Y|N} 

UNITADD = nnn 





Device Features 


code this value 
on the parameter, 


To indicate the presence of this 
feature: FEATURE = 


Character generator (Select only one) 
United States English (default) DOCHAR 
French FRCHAR 
German GRCHAR 
Katakana KACHAR 


United Kingdom UKCHAR 


The 3288 is attached PTREAD 
to a 3274-D control unit. 

This feature may improve 

the performance of the 3288 

if programs that access the 

device use the appropriate 

channel programs. 
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_ 
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Display Device 3289-1 or 2 


3289 Model 1 or 2 Printer 


Required Parameters 


Optional Parameters 


Device Features 





You must define this device as either a 3284 or a 3286. If you plan to use this 
device as an operator’s console, IBM recommends that you define it as a 3286-2 
(UNIT = 3286,MODEL = 2). 


ADDRESS = {device-number|(device-number number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number/[ number ]...) 
MODEL = {12} 
UNIT = {3284|3286} 





FEATURE = (feature/ feature ]...)(See “Device Features.”’) 
OFFLINE ={YES|NO} 

PATH =chpid 

STADET = {Y|N} 

TIMEOUT ={Y|N} 

UNITADD =nnn 





code this value 
on the parameter, 
To indicate the presence of this 
feature: FEATURE = 


Character generator (Select only one) 
United States English (default) DOCHAR 
French FRCHAR 
German GRCHAR 
Katakana KACHAR 


United Kingdom UKCHAR 


The 3289 is attached PTREAD 
to a 3274-D control unit. 

This feature may improve 

the performance of the 3289 

if programs that access the 

device use the appropriate 

channel programs. 
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Display Device 3290 


3290 Information Panel 


e You must define the 3290 as a 3270-X. How to do this is explained in “3270 } 
Model X” on page 6-30. | 


e To customize the 3274 control unit, you must answer a series of questions 
about the configuration of the devices that are attached to the control unit. 
For MCS operator consoles, you must answer question 173 so that bit 7 
(update panel before allowing buffer change) will be set to one. Having bit 7 
set to one ensures that messages previously sent to the 3290 are displayed 
before new messages are accepted. In other words, setting bit 7 to one 
prevents the 3290 from losing messages. 
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Display Device 5080 


5080 Graphics Device 


e This topic explains how to define the 5080 so it can be used in full- function 
mode. The 5080, when defined in full-function mode, is also called a high 
function graphics device (HFGD). 


The system on which you run the MVS configuration program to define the 
5080, and the system on which you use the 5080 must both have Graphics 
Access Method/SP2 (GAM /SP2) installed. 


For more information about required products, see “Other Products May be 
Required” on page 6-5. 


e You can also define the 5080 so it can be used in 3250-compatibility mode. 
This use of the 5080 requires that you define it as a 2250-3. For information 
about defining a 2250-3, see “2250 Model 3” on page 6-25. 


Required Parameters 


ADDRESS = {device-number|(device-number number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number/[ number /...) 
UNIT =HFGD 





Optional Parameters 


OFFLINE = {YES|NO} 
PATH= chpid 
STADET = {Y|N} 


TIMEOUT = {Y|N} 
UNITADD = nnn 





Device Features 


None supported. 
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Magnetic Tape Device Definitions 


This topic explains how to code IODEVICE statements for supported magnetic JZ 
tape devices. The documentation for each device starts on a new page and 

includes: 

e Required parameters 

e Optional parameters 

e Device features (if applicable) 

Devices are arranged in ascending numerical order by device type. The heading 


at the top of each page identifies the class of device, magnetic tape, the device 
type, and model. 
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C 


Magnetic Tape 3420-3, 5, or 7 


3420 Model 3, 5, or 7 Magnetic Tape Unit 


Required Parameters 


Optional Parameters 


ADDRESS = {device-number|(device-number number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number[ number ]...) 
MODEL = {3|5]7} 
UNIT = 3420 





FEATURE = (feature/ feature ]...) (See “Device Features” on page 6-52.) 
OFFLINE = {YES|NO} 


Note: If you specify the SHARABLE feature, The MVS configuration 
program forces the 3420 offline even if you specify OFFLINE=NO. 


PATH = chpid 
STADET = {Y|N} 
TIMEOUT = {Y|N} 
UNITADD = nnn 





(Continued on next page) 
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Magnetic Tape 3420-3, 5, or 7 
Device Features 


code this value 
on the parameter, 
To indicate the presence of this 
feature: FEATURE= 


There is a separate physical ALTCTRL 
control unit path that 
can be used. 


Data conversion DATACONV 
If you specify DATACONV, you 
must also specify 7-TRACK. 


The tape unit can be used DUALDENS 
at either 800BPI or 1600BPI. 


The 3803 two-channel SHARABLE 
switch is used for partitioning. 

Magnetic tape drives can be 

shared between two processors. 


Do not allocate or unload a 
shared tape drive. 


OFFLINE = YES is forced 


Track type (select only one) 


7-track enables the 3420 to 7-TRACK 
process binary coded decimal 

(BCD) or binary format tapes. 

These tapes are compatible 

with the 727, 729, and 730 

tape drives. 


9-TRACK enables the 3420 to 9-TRACK 
process tapes in 9 track 
format. 


The default is 9-TRACK. 
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Magnetic Tape 3420-4, 6, or 8 
3420 Model 4, 6, or 8 Magnetic Tape Unit 


C 


Required Parameters 


ADDRESS = {device-number |(device-number number-of-units)} 


Note: The default for number-of-units 1s 1. 
CUNUMBR = (number/[ number |...) 
MODEL = {4|6|8} 
UNIT = 3420 





Optional Parameters 


FEATURE = (feature/ feature/]...) (See “Device Features.”) 
OFFLINE = {YES|NO} 


Note. If you specify the SHARABLE feature, The MVS configuration 
program forces the 3420 offline even if you specify OFFLINE=NO. 


PATH = chpid 
STADET = {Y|N} 
TIMEOUT = {Y|N} 
UNITADD =nnn 





Device Features 


code this value 
on the parameter, 


To indicate the presence of this feature: FEATURE = 


There is a separate physical control ALTCTRL 
unit path that can be used. 


The 3420 can be used at either OPT1600 
1600 BPI or 6250 BPI. 


The 3803 two-channel switch is used SHARABLE 
for partitioning. Magnetic tape drives 
can be shared between two processors. 


Do not allocate or unload a shared 
tape drive. 


OFFLINE = YES is forced 
The 3420 has the 9 track feature. 9-TRACK 
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Magnetic Tape 3430 


3430 Magnetic Tape Unit 


Required Parameters 2 


ADDRESS = {device-number |(device-number number-of-units)} 


Note: The default for number-of-units 1s 1. 


CUNUMBR = (number/ number |...) 
UNIT = 3430 





Optional Parameters 







FEATURE = (feature/ feature]...) (See “Device Features.”) 
OFFLINE = {YES|NO} 
PATH = chpid 
STADET = {Y|N} 
TIMEOUT = {Y|N} 
UNITADD = nnn 


Device Features 


code this value ) 
on the parameter, 

To indicate the presence of this 

feature: FEATURE= 

The 3420 can be used OPT1600 


at either 1600 BPI or 
6250 BPI. 


The 3420 has the 9 track 9-TRACK 
feature. 
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Magnetic Tape 3480 


3480 Magnetic Tape Unit 
You can define the 3480 to operate in one of two modes: 


@ 3480 full function mode -- MVS supports all of the 3480 functions. (Code 
UNIT = 3480). 


@ 3420 code compatibility mode -- MVS supports the 3480 as though it were a 
3420. All of the 3420 channel programs will execute on the 3480. (Code 
UNIT = 34200). 


Note: Do not define both modes within the same I/O configuration. 


Required Parameters 


ADDRESS = { device-number|(device-number number-of-units)} 


Notes: 


1. IBM recommends that you define all 16 possible addresses. To do this, 
code ADDRESS = (device-number, 16 ). 
2. The default for number-of-units is 1. 


CUNUMBR = (number/[ number }...) 
UNIT = {3420C|3480} 





(continued on next page) 
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Magnetic Tape 3480 


Optional Parameters 


FEATURE = (feature/ feature]...) (See “Device Features.”’) 


OFFLINE = {YES|NO} 


Note: If you specify the SHARABLE feature, The MVS configuration 
program forces the 3480 offline even if you specify OFFLINE= NO. 


PATH = chpid 
STADET = {Y|N} 
TIMEOUT = {Y|N} 
UNITADD = nnn 


Device Features 


To indicate the presence of this 
feature: 


There is a separate physical 
control unit path that 
can be used. 


The 3803 two-channel 

switch is used for partitioning. 
Magnetic tape drives can be 
shared between two processors. 


Do not allocate or unload a 
shared tape drive. 


OFFLINE= YES is forced 
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code this value 
on the parameter, 


FEATURE = 


ALTCTRL 


SHARABLE 





Miscellaneous I/O Device Definitions 


Cc This topic explains how to code IODEVICE statements for: 
@ Supported miscellaneous devices. 
@ Unsupported devices that you want MVS to treat as DUMMY devices. 
The documentation for each device starts on a new page and includes: 
@ Required parameters 
e Optional parameters 
e Device features (if applicable) 
Devices are arranged in ascending numerical order by device type. The heading 


at the top of each page identifies the class of device, miscellaneous devices, the 
device type, and model. 


(continued on next page) 
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Miscellaneous - DUMMY Device 


DUMMY Device 


This book also refers to a DUMMY device as an unsupported device. 
MVS supports each DUMMY device as a unit record device. For additional 
information about defining a DUMMY device, see “Defining an Unsupported 


Device” on page 6-4. 


For information about migrating a DUMMY device, see “Migrating a Dummy 
Device” on page 8-2. 


Required Parameters 


ADDRESS = {device-number|(device-number number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number number ]...) 
UNIT = DUMMY 





Optional Parameters 


OFFLINE = {YES|NO} 
PATH = chpid 
STADET = {¥|N} 


TIMEOUT = {¥|[N} 
UNITADD =nnn 





Device Features 


None supported. 


6-58 MVS/XA MVS Configuration Program Guide and Reference 


Miscellaneous - Optical Reader 1287 


1287 Optical Reader 
‘ The system on which you run the MVS configuration program, and the system on 
which you use the 1287 must both have the Magnetic ink character reader/optical 
character reader (MICR/OCR) support installed. 


For more information about required products, see “Other Products May be 
Required” on page 6-5. 


Required Parameters 


ADDRESS = {device-number|(device-number number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number/[ number |...) 
UNIT = 1287 





Optional Parameters 


OFFLINE = {YES|NO} 
PATH =chpid 
STADET = {Y|N} 


TIMEOUT = {¥|N} 
UNITADD = nnn 





Device Features 


None supported. 
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Miscellaneous - Optical Page Reader 1288 


1288 Optical Page Reader 


The system on which you run the MVS configuration program, and the system on 
which you use the 1288 must both have the Magnetic ink character reader/optical 


character reader (MICR/OCR) support installed. 


For more information about required products, see “Other Products May be 


Required” on page 6-5. 


Required Parameters 


ADDRESS = {device-number|(device-number number-of-units)\ 


Note: The default for number-of-units is 1. 


CUNUMBR = (number|[ number |...) 
UNIT = 1288 


Optional Parameters 


OFFLINE = {YES|NO} 
PATH =chpid 
STADET ={Y|N} 


TIMEOUT = {Y|N} 








UNITADD = nnn 


Device Features 


None supported. 
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Miscellaneous - Diskette 3540 


3540 Diskette I/O Unit 
( The system on which you run the MVS configuration program, and the system on 
which you use the 3540 must both have the Magnetic ink character reader/optical 


character reader (MICR/OCR) support installed. 


For more information about required products, see “Other Products May be 
Required” on page 6-5. 


Required Parameters 


ADDRESS = {device-number |(device-number number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number{ number /...) 
UNIT = 3540 





Optional Parameters 


OFFLINE = {YES|NO} 
PATH = chpid 
STADET = {Y|N} 


TIMEOUT = {Y|N} 
UNITADD = nnn 





Device Features 


None supported. 
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Miscellaneous - Array Processor 3838 


3838 Array Processor 


Required Parameters 


Optional Parameters 


Device Features 


The system on which you run the MVS configuration program, and the system on 
which you use the 3838 must both have the Vector Processing 
Subsystem/Extended Architecture (VPSS/XA) support installed. 


For more information about required products, see “Other Products May be 
Required” on page 6-5. 


ADDRESS = (device-number,1) 


Note: The low-order digit (the rightmost digit) of the device-number must be 
0. You could code, for example, ADDRESS =(110,1) or 
ADDRESS = (540, 1). 


The MVS configuration program assigns eight device numbers to the 3838: 


the device number you specify plus the next seven consecutive device 
numbers. For example, if you specify ADDRESS =(210,1), the MVS 
configuration program assigns the 3838 device numbers 210, 211, 212, 213, 
214, 215, 216, and 217. 


CUNUMBR = (number/[ number J...) 
UNIT = 3838 





OFFLINE = {YES|NO} 
PATH = chpid 
STADET = {Y|N} 


TIMEOUT = {Y|N} 
UNITADD = nnn 





None supported. 
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Miscellaneous - Cryptographic Device 3848 


3848 Cryptographic Unit 


Required Parameters 


Optional Parameters 


Device Features 


The system on which you run the MVS configuration program, and the system on 
which you use the 3848 must both have the cryptographic unit support installed. 


For more information about required products, see “Other Products May be 
Required” on page 6-5. 


ADDRESS = {device-number |(device-number number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number[ number /...) 
MODEL = 1 
UNIT = 3848 





OFFLINE = {YES|NO} 
PATH = chpid 


STADET = {¥|N} 
TIMEOUT = {Y|N} 
UNITADD = nnn 





None supported. 
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Miscellaneous - Optical Character Reader 3886 


3886 Optical Character Reader 


The system on which you run the MVS configuration program, and the system on 
which you use the 3886 must both have the Magnetic ink character reader/optical 


character reader (MICR/OCR) support installed. 


For more information about required products, see “Other Products May be 


Required” on page 6-5. 


Required Parameters 


ADDRESS = {device-number|(device-number, number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number|[ number J...) 
UNIT = 3886 


Optional Parameters 


OFFLINE = {YES|NO} 
PATH = chpid 
STADET ={Y|N} 


TIMEOUT = {Y|N} 
UNITADD = nnn 








Device Features 


None supported 
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Miscellaneous - Document Processor 3890 


3890 Document Processor 
Cc The system on which you run the MVS configuration program, and the system on 
which you use the 3890 must both have the Magnetic ink character reader/optical 
character reader (MICR/OCR) support installed. 


For more information about required products, see “Other Products May be 
Required” on page 6-5. 


Required Parameters 


ADDRESS = {device-number|(device-number number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number/[ number /...) 
UNIT = 3890 





Optional Parameters 


OFFLINE = {YES|NO} 
PATH = chpid 
STADET ={Y|N} 


TIMEOUT = {Y|N} 


( UNITADD =nnn 


Device Features 





None supported. 
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Miscellaneous - Document Reader/Inscriber 3895 


3895 Document Reader/Inscriber 
The system on which you run the MVS configuration program, and the system on 
which you use the 3895 must both have the Magnetic ink character reader/optical 
character reader (MICR/OCR) support installed. 


For more information about required products, see “Other Products May be 
Required” on page 6-5. 


Required Parameters 


ADDRESS = {device-number|(device-number number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number/[ number j...) 
UNIT = 3895 





Optional Parameters 


OFFLINE = {YES|NO} 
PATH = chpid 
STADET ={Y|N} 


TIMEOUT = {Y|N} 
UNITADD = nnn 





Device Features 


None supported. 
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MSS Device Definitions 


This topic explains how to code IODEVICE statements for the Mass Storage 
Subsystem. The documentation for each device starts on a new page and 
includes: 

e Required parameters 

e Optional parameters 

e Device features (if applicable) 

Devices are arranged in ascending numerical order by device type. The heading 
at the top of each page identifies the class of device, MSS, the device type, and 
model. 

To define the IBM Mass Storage Subsystem, you must define both a IBM 3330 
Disk Storage Unit and a IBM 3851 Mass Storage Facility. 


(continued on next page) 
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MSS 3330 (3330V Used in an MSS) 


3330 Disk Storage Unit (Used as a Virtual Volume in an MSS) 
The 3330V is functionally equivalent to the 3330/3333 model 1. : ) 


When you define the 3330V you must also define the 3851. For information 
about defining the 3851, see “3851 Mass Storage Facility” on page 6-69. 


The system on which you run the MVS configuration program, and the system on 
which you use the 3330V must both have the Mass Storage Subsystem/Extended 
Architecture (MSS/XA) support installed. 


For more information about required products, see “Other Products May be 
Required” on page 6-5. 


Required Parameters 


ADDRESS = {device-number|(device-number ,number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number/[ number j...) 
UNIT =3330V 





Optional Parameters 


FEATURE = (feature/ feature]...) (See “Device Features.’’) J 
OFFLINE = {YES|NO} 

PATH = chpid 

STADET = {Y|N} 

TIMEOUT = {Y|N} 

UNITADD = nnn 





Device Features 


code this value 
on the parameter, 


To indicate the presence of this feature: FEATURE = 


There is a separate physical ALTCTRL 
control unit path to the device. 


DASD sharing and reserve/release 
logic usage: (Specify only one.) 


Share device with other systems; Use SHARED 
reserve/release logic as needed. 


Use reserve/release logic only when the SHAREDUP 
system is physically partitioned. 
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MSS 3851 


3851 Mass Storage Facility 


C 


Required Parameters 


Optional Parameters 


Device Features 


To fully define the 3851 mass storage facility: 


Code an IODEVICE statement to define the 3851 as explained below. 


Code an IODEVICE statement to define the 3330V as explained in the topic 
3330 Disk Storage Unit (Used as a Virtual Volume in an MSS)” on 
page 6-68. 


During the SYSGEN process for the system on which the 3851 will be used, 
specify MSS= YES on the DATAMGT macro instruction. For more 
information on the DATAMGT macro instruction, see MVS/Extended 
Architecture Installation: System Generation 


The system on which you run the MVS configuration program, and the system on 
which you use the 3851 must both have the Mass Storage Subsystem/Extended 
Architecture (MSS/XA) support installed. 


For more information about required products, see “Other Products May be 
Required” on page 6-5. 


ADDRESS = {device-number|(device-number number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number/[ number /...) 
UNIT = 3851 





OFFLINE = {YES|NO} 
PATH =chpid 
STADET = {Y|N} 


TIMEOUT ={Y|N} 
UNITADD = nnn 





None supported 
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Telecommunication Device Definitions 


This topics explains how to code IODEVICE statements for supported 
telecommunication devices. The documentation for each device starts on a new 
page and includes: 


@e Required parameters 
e Optional parameters 
e Device features (if applicable) 


Devices are arranged in ascending alphanumerical order by device type. The 
heading at the top of each page identifies the class of device, telecommunication, 
the device type, and model. 


Before defining any telecommunication devices, read the following topic 
“Defining Telecommunication Devices.” That topic provides 

information about those devices that you must define through the MVS 
configuration program and those that you must not. 






Defining Telecommunication Devices 


All telecommunication devices attached to a given line must be of the same type. 
All of these devices must also have the same features. 


To define telecommunication devices, code one IODEVICE statement for each: 

e Telecommunications line. Do not code an IODEVICE statement for each 
device on the line. One IODEVICE statement is all that is needed to define 
one line and all of the devices on that line. Use the UNIT parameter on the 
IODEVICE statement to specify the type of device that is on the line. 

e Locally attached IBM 3704 Communications Controller 


e Locally attached IBM 3705 Communications Controller 


@ Locally attached IBM 3791 Communications Controller 


3704, 3705 Emulation Program Considerations 
If you plan to use a locally attached 3704 or 3705 with the emulation program, 


you must code one IODEVICE statement for the 3704 or 3705. You must also 
code an IODEVICE statement for each line that will operate in emulation mode. 
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Virtual Telecommunications Access Method (VTAM) Considerations 


( In a VTAM telecommunications network, you need code IODEVICE statements 
only for: 


e Each locally attached IBM 3270 Information Display System 
@ Each locally attached IBM 3704 or 3705 Communication Controller 


Other devices that are included in the network are not defined through the MVS 
configuration program. Instead, they are defined through the VTAM network 
definition process. 


Note: VTAM network definition is a separate process. For more information, 
see the VTAM and Network Control Program (NCP) books that apply to the 
version and release level of the VTAM and NCP products that are installed. 


There is one exception to the previously stated rule about locally 
attached 3704 or 3705 Communications Controllers ina VTAM 
network: if a locally attached 3704 or 3705 ina VTAM network also 


supports a non-VTAM network through an NCP with the partitioned 
emulation programming (PEP) extension, you must code an 
IODEVICE statement for each line that will be operated in emulation 
mode. 
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Telecommunications Device - BSC1, BSC2, and BSC3 


BSC1, BSC2, and BSC3 





Required Parameters 


ADAPTER =BSCA 
ADDRESS = {device-number|(device-number number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number/f number /...) 
TCU = {2701 |2702|2703} 


Notes: 


1. If the telecommunications line connects to a 3705 that is operating in 
emulator mode, specify 2702 or 2703. 


2. For BSC1 only: if you specify either TCU=2702 or TCU=2703, omit 
the FEATURE parameter. 


UNIT = {BSC1|BSC2|BSC3} 


Notes: 


1. For devices connected to a non-switched point-to-point line, code BSC]. 
2. For devices connected to a switched point-to-point line, code BSC2. 
3. For devices connected to a nonswitched multipoint line, code BSC3. 





Optional Parameters 


FEATURE = (feature/ feature ]...) (See “Device Features” on page 6-73.) 
OFFLINE = {YES|NO} 

PATH= chpid 

STADET = {Y|N} 

TIMEOUT ={¥|N} 

UNITADD =nnn 
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Device Features 


Telecommunications Device - BSC1, BSC2, and BSC3 


code this value 
on the parameter, 
To indicate the presence of this 
feature: FEATURE = 


The modem that connects the TCU AUTOANSR 
to the telecommunication line 
is a switched line over which 
calls are to be answered. 
This is the default for BSC2. 
If you specify UNIT = BSC3, do not 
specify AUTOANSR. 


The TCU has the autocall feature AUTOCALL 
and the line is connected to 
the TCU terminal adapter 
through an automatic calling 
unit. 
Code for BSC2 only. 


The TCU has an automatic polling AUTOPOLL 
feature. 

This is the default for BSC3. 

If you specify UNIT = BSC2, do not 

specify AUTOPOLL. 


The TCU has the dual code DUALCODE 
feature. 

Specify DUALCODE only if the 

device is connected to a 2701. 


The TCU has the dual DUALCOMM 
communication interface feature. 

Specify DUALCOMM only if the 

device is connected to a 2701. 
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Telecommunications Device - TWX (Teletype)! Model 33 or 35 


TWX (Teletype) Model 33 or 35 


Required Parameters 


Optional Parameters 


ADAPTER = TELE2 
ADDRESS = {device-number|(device-number number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number] number /...) 
TCU = {2701|2702|2703} 


Note: If the telecommunications line connects to a 3705 that is operating 
in emulator mode, specify 2702 or 2703. 


UNIT = TWX 










FEATURE = (feature/ feature ]...) (See “Device Features” on page 6-75.) 
OFFLINE = {YES|NO} 

PATH =chpid 
SETADDR = {0|1/2|3} 


Note: If you code TCU =2702, also code the SETADDR parameter. 







STADET = {Y|N} 
TIMEOUT = {Y|N} 
UNITADD = nnn 


l Trademark of Teletype Corporation. 
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Device Features 


To indicate the presence of this 
feature: 


The modem that connects the TCU 
to the telecommunication line 

is a switched line over which 

calls are to be answered. 


The TCU has the autocall feature 
and the line is connected to 

the TCU terminal adapter 
through an automatic calling 
unit. 





Telecommunications Device - TWX (Teletype) Model 33 or 35 


code this value 
on the parameter, 


FEATURE = 


AUTOANSR 


AUTOCALL 
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Telecommunications Device - WI'TA (IBM WTC Telegraph Terminal) 


WTTA (IBM World Trade Corporation Telegraph Terminal) 


Required Parameters 


ADAPTER = TELEW 
ADDRESS = {device-number|(device-number number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number number /...) 
TCU = {2701 |2702|2703} 


Note: If the telecommunications line connects to a 3705 that is operating 
in emulator mode, specify 2702 or 2703. 


UNIT=WITTA 





Optional Parameters 


OFFLINE = {YES|NO} 
PATH = chpid 
SETADDR = {0]1|2]3} 


Note: If you code TCU =2702, also code the SETADDR parameter. 


STADET ={Y|N} J 
TIMEOUT ={Y|N} 


UNITADD =nnn 





Device Features 


None supported. 
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Telecommunications Device - 1030 


1030 Data Collection System 


C 


Required Parameters 


Optional Parameters 


Device Features 





ADAPTER = IBM2 
ADDRESS = {device-number|(device-number number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number/[ number /...) 
TCU = {2701 |2702|2703} 


Note: If the telecommunications line connects to a 3705 that is operating 
in emulator mode, specify 2702 or 2703. 


UNIT = 1030 





FEATURE = feature (See “Device Features.’’) 
OFFLINE = {YES|NO} 

PATH =chpid 

SETADDR = {0|1|2|3} 


Note: If you code TCU =2702, also code the SETADDR parameter. 
STADET = {Y|N} 


TIMEOUT = {Y|N} 
UNITADD = nnn 





code this value 
on the parameter, 
To indicate the presence of this 
feature: FEATURE= 


The TCU has an automatic polling AUTOPOLL 
feature. Specify this feature 

only for lines connected through 

a type II synchronous data adapter. 


Chapter 6. Defining I/O Devices 6-77 


Telecommunications Device - 1050 


1050 Data Communications System 


Required Parameters 


Optional Parameters 


ADAPTER = {IBM1|IBMT} 
Notes: 


I. If the connection is through a terminal adapter or a line adapter, code 
IBM 1. 


If the connection is through a telegraph adapter or a telegraph line 
adapter, code IBMT. 


ADDRESS = {device-number|(device-number number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number[ number ]...) 
TCU = {2701 |2702|2703} 


Notes: 


1. If you code ADAPTER=IBMT, code either TCU=2701 or 
TCU=2703. 


2. If you code ADAPTER=IBM1 and the telecommunications line 
connects to a 3705 that is operating in emulator mode, code either 
TCU=2702 or TCU=2703. 


UNIT =1050 








FEATURE = (feature/ feature ]...) (See “Device Features” on page 6-79.) 
OFFLINE = {YES|NO} 

PATH= chpid 
SETADDR = {0]1|2|3} 







Note: If you code TCU =2702, also code the SETADDR parameter. 







STADET = {Y|N} 
TIMEOUT ={Y|N} 
UNITADD = ann 
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C 


Device Features 


Telecommunications Device - 1050 


To indicate the presence of this 
feature: 


The modem that connects the TCU 
to the telecommunication line 

is a switched line over which 

calls are to be answered. 


The TCU has the autocall feature 
and the line is connected to 
the TCU terminal adapter 


through an automatic calling 
unit. 


The TCU has an automatic polling 
feature. Specify this feature 
only for lines connected through 
a type II synchronous data 
adapter. 

If you specify either 


AUTOANSR, AUTOCALL, or both, 


do not specify 
AUTOPOLL 





code this value 
on the parameter, 


FEATURE = 


AUTOANSR 


AUTOCALL 


AUTOPOLL 
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Telecommunications Device - 1050X (1050 with Timeout Suppression) 


1050X (1050 Data Communications System with Timeout Suppression) 


Required Parameters 


ADAPTER = {IBM1|IBMT} 
Notes: 
I. If the connection is through a terminal adapter or a line adapter, code 
2: He ces is through a telegraph adapter or a telegraph line 
adapter, code IBMT. 
ADDRESS = {device-number|(device-number ,number-of-units)} 
Note: The default for number-of-units is 1. 


CUNUMBR = (number/[ number /...) 
TCU = {2701 |2702|2703} 


Notes: 


I. Ifyou code ADAPTER=IBMT, code either TCU=2701 or 
TCU=2703. 


If you code ADAPTER=IBM1 and the telecommunications line 
connects to a 3705 that is operating in emulator mode, code either 
TCU=2702 or TCU=2703. ) 


UNIT = 1050X 





Optional Parameters 


FEATURE = (feature/ feature ]...) (See “Device Features” on page 6-81.) 
OFFLINE = {YES|NO} 

PATH = chpid 
SETADDR = {0[1]2|3} 







Note: If you code TCU =2702, also code the SETADDR parameter. 






STADET = {Y|N} 
TIMEOUT = {Y|N} 
UNITADD =nnn 
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C 


Telecommunications Device - 1050X (1050 with Timeout Suppression) 


Device Features 


To indicate the presence of this 
feature: 


The modem that connects the TCU 
to the telecommunication line 

is a switched line over which 

calls are to be answered. 


The TCU has the autocall feature 
and the line is connected to 

the TCU terminal adapter 
through an automatic calling 
unit. 





code this value 
on the parameter, 


FEATURE = 


AUTOANSR 


AUTOCALL 
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Telecommunications Device - 115A (Western Union Terminal) 


115A (Western Union Terminal) 


Required Parameters 


ADAPTER =TELE1 
ADDRESS = {device-number|(device-number, number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number|[ number J...) 
TCU = {2701 |2702|2703} 


Note: If the telecommunications line connects to a 3705 that is operating 
in emulator mode, specify 2702 or 2703. 





UNIT=115A 


Optional Parameters 


OFFLINE = {YES|NO} 
PATH = chpid 
SETADDR = {0]1|23} 


Note: If you code TCU =2702, also code the SETADDR parameter. 


STADET = {Y|N} 
TIMEOUT = {Y|N} 
UNITADD = ann 





Device Features 


None supported. 


2 Trademark of Western Union Telegraph Company. 
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C 


Telecommunications Device - 2740 


2740 Communication Terminal 


Required Parameters 


Optional Parameters 


ADAPTER = IBM1 
ADDRESS = {device-number|(device-number number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number/[ number ]...) 
TCU = {2701|2702|2703} 


Note: If the telecommunications line connects to a 3705 that is operating 
in emulator mode, specify 2702 or 2703. 


UNIT =2740 





FEATURE = (feature/ feature]...) (See “Device Features” on page 6-84.) 
OFFLINE ={YES|NO} 

PATH = chpid 

SETADDR = {0|1|2|3} 


Note: If you code TCU =2702, also code the SETADDR parameter. 


STADET = {Y|N} 
TIMEOUT = {Y|N} 
UNITADD = nnn 





(Continued on next page) 
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Telecommunications Device - 2740 
Device Features 


code this value 
on the parameter, 


To indicate the presence of this feature: FEATURE = 


The modem that connects the TCU to the AUTOANSR 
telecommunication line is a switched 
line over which calls are to be answered. 


The TCU has the autocall feature and the AUTOCALL 
line is connected to the TCU terminal 
adapter through an automatic calling unit. 


The TCU has an automatic polling AUTOPOLL 
feature. Specify this feature 
only for lines connected through 
a type II synchronous data adapter. 
If you specify AUTOPOLL, also 
specify SCONTROL. 


If you specify either AUTOANSR, 
AUTOCALL, or both, do not 
specify AUTOPOLL. 


The terminal has the record CHECKING 
checking feature. 

If you specify OIU, you must 

also specify CHECKING. 


The terminal is a model 1 with INTERRUPT 
RPQ #830031 installed. 


The terminal is equipped with the OIU 
IBM 2760 optical image unit. 

You must also specify CHECKING. 

Besides CHECKING, the only 

other features you can specify 

are AUTOANSR and AUTOCALL. 


The terminal is equipped with SCONTROL 
the station control feature. 

If you specify SCONTROL, do not 

specify AUTOANSR, AUTOCALL, 

OIU, or XCONTROL. 


The terminal is equipped with XCONTROL 
the dial-up feature. 

You must also specify AUTOANSR, 

AUTOCALL, or both as appropriate. 

Do not specify OIU. 
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C 





Telecommunications Device - 2740C (2740 with Correspondence Code) 


2740C (2740 Communication Terminal with Correspondence Code) 


Required Parameters 


Optional Parameters 


Device Features 





ADAPTER = IBM1 
ADDRESS = {device-number|(device-number number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number[ number J...) 
FEATURE = CHECKING |(CHECKING|,feature]...) (See “Device Features.”) 
TCU = {2701 |2702|2703} 


Note: If the telecommunications line connects to a 3705 that is operating 
in emulator mode, specify 2702 or 2703. 


UNIT = 2740C 





OFFLINE = {YES|NO} 
PATH = chpid 
SETADDR = {0]1|2(3} 


Note: If you code TCU =2702, also code the SETADDR parameter. 


STADET = {Y|N} 
TIMEOUT = {¥|N} 
UNITADD = nnn 





code this value 
on the parameter, 


To indicate the presence of this feature: FEATURE = 


The modem that connects the TCU AUTOANSR 
to the telecommunication line 

is a switched line over which 

calls are to be answered. 


The TCU has the autocall feature AUTOCALL 
and the line is connected to the 

TCU terminal adapter through 

an automatic calling unit. 


The terminal has the record CHECKING 
checking feature. 
CHECKING is required 
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Telecommunications Device - 2740X (2740 with PTTC: Code) 


2740X (2740 Communication Terminal with PTTC Code) 


Required Parameters 


ADAPTER = IBM 1 
ADDRESS = {device-number|(device-number number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number number ]...) 
FEATURE = CHECKING|(CHECKING|,feature]...) (See “Device Features” 


on page 6-87.) 
TCU = {2701 |2702|2703} 


Note: If the telecommunications line connects to a 3705 that 1s operating 
in emulator mode, specify 2702 or 2703. 


UNIT = 2740X 





Optional Parameters 


OFFLINE = {YES|NO} 
PATH =chpid 
SETADDR = {0|1|2|3} 


Note: If you code TCU =2702, also code the SETADDR parameter. 


STADET = {¥|N} 
TIMEOUT = {Y|N} 
UNITADD = nnn 





3 Perforated tape and transmission code. 
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C 


Device Features 


To indicate the presence of this 
feature: 


The modem that connects the TCU 
to the telecommunication line 

is a switched line over which 

calls are to be answered. 


The TCU has the autocall feature 
and the line is connected to 

the TCU terminal adapter 
through an automatic calling 
unit. 


The terminal has the record 
checking feature. 
CHECKING is required. 





Telecommunications Device - 2740X (2740 with PTTC Code) 


code this value 
on the parameter, 


FEATURE = 


AUTOANSR 


AUTOCALL 


CHECKING 
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Telecommunications Device - 2741C (2741 with Correspondence Code) 


2741C (2741 Communication Terminal with Correspondence Code) 


Required Parameters 


Optional Parameters 


Device Features 





ADAPTER = IBM1 
ADDRESS = {device-number |(device-number number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number/[ number ]...) 
TCU = {2701 |2702|2703} 


Note: If the telecommunications line connects to a 3705 that is operating 
in emulator mode, specify 2702 or 2703. 





UNIT =2741C 


FEATURE = feature (See “Device Features.”’) 
OFFLINE = {YES|NO} 

PATH =chpid 

SETADDR = {0|1|2|3} 


Note: If you code TCU =2702, also code the SETADDR parameter. 
STADET = {Y|N} 


TIMEOUT = {¥|N} 
UNITADD = nan 





code this value 
on the parameter, 
To indicate the presence of this 
feature: FEATURE= 


The modem that connects the TCU AUTOANSR 
to the telecommunication line 

is a switched line over which 

calls are to be answered. 
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Telecommunications Device - 2741P (2741 with PTTC Code) 


2741P (2741 Communication Terminal with PTTC Code) 


c 


Required Parameters 


Optional Parameters 


Device Features 





ADAPTER = IBM1 
ADDRESS = {device-number|(device-number number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number/[ number ]...) 
TCU = {2701 |2702|2703} 


Note: If the telecommunications line connects to a 3705 that is operating 
in emulator mode, specify 2702 or 2703. 


UNIT =2741P 





FEATURE= feature (See “Device Features.”) 
OFFLINE = {YES|NO} 

PATH = chpid 

SETADDR = {0[1]2]3} 


Note: If you code TCU = 2702, also code the SETADDR parameter. 
STADET = {Y|N} 


TIMEOUT ={Y|N} 
UNITADD = nnn 





code this value 
on the parameter, 
To indicate the presence of this 
feature: FEATURE= 


The modem that connects the TCU AUTOANSR 
to the telecommunication line 

is a switched line over which 

calls are to be answered. 
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Telecommunications Device 3274-1A 


3274 Model 1A Control Unit 


1. If the 3274-1A is locally attached and it has systems network architecture JZ 
(SNA) support that permits the control of multiple devices through one device 
number, code an IODEVICE statement for the 3274-1A. 


You must define the 3274-1A as though it were a 3791L. For instructions on 
how to code the IODEVICE statement, see “3791L Controller” on page 6-95. 


Do not code IODEVICE statements for any of the devices attached to the 
3274-1A. 


2. If each device that is attached to the 3274-1A has its own device number, do 
not code an IODEVICE statement for the 3274-1A. You must, instead, code 
an IODEVICE statement for each of the attached devices. For instructions 
on how to code the IODEVICE statements, see the appropriate device 
descriptions in this chapter. 
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Telecommunications Device - 3704 


3704 Communications Controller 


c 


Required Parameters 


Optional Parameters 


Device Features 


ADDRESS = {device-number|(device-number number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number/ ,number /...) 
UNIT = 3704 





ADAPTER =CAI1 
OFFLINE = {YES|NO} 
PATH = chpid 


STADET = {Y|N} 
TIMEOUT = {Y|N} 
UNITADD = nnn 





None supported. 
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Telecommunications Device - 3705 


3705 Communications Controller 


Required Parameters 


ADAPTER = {CA1|CA2} 


Notes: 


1. If the channel adapter is a type 3, code CA2. 
2. If the channel adapter is a type 4, code CAI. 


ADDRESS = {device-number|(device-number number-of-units)} 
Note: The default for number-of-units is 1. 


CUNUMBR = (number/[ number ]...) 
UNIT =3705 





Optional Parameters 


OFFLINE = {YES|NO} 
PATH = chpid 
STADET = {Y|N} 


TIMEOUT = {Y|N} 
UNITADD = nnn 





Device Features 


None supported. 
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Telecommunications Device - 3725 


3725 Communications Controller 
The 3725 is functionally equivalent to a 3705. Therefore, you must define the 


3725 just as though it were a 3705. For instructions on how to code the 
IODEVICE statement, see “3705 Communications Controller” on page 6-92. 
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Telecommunications Device - 3767 


3767 Communication Terminal 


The 3767 model 1 or 2 is functionally equivalent to a 2740 model 1. You must - 
define the 3767 just as though it were a 2740 model |. For instructions on how to 

code the IODEVICE statement, see “2740 Communication Terminal” on 

page 6-83. 
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Telecommunications Device - 3791L (3791 Used as Local Channel Attachment) 


3791L Controller 


Required Parameters 


Optional Parameters 


Device Features 


ADDRESS = {device-number|(device-number number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number| number J...) 
UNIT =3791L 





OFFLINE = {YES|NO} 
PATH = chpid 
STADET = {Y|N} 


TIMEOUT = {Y|N} 
UNITADD = nnn 





None supported. 
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Telecommunications Device - 7770 


7770 Audio Response Unit 


Required Parameters 


ADDRESS = {device-number|(device-number number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number| number ]...) 
MODEL =3 
UNIT =7770 





Optional Parameters 


OFFLINE = {YES|NO} 
PATH = chpid 
STADET ={Y|N} 


TIMEOUT = {Y|N} 
UNITADD = nnn 





Device Features 


None supported. 
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Telecommunications Device - 83B3 (AT&T: Selective Calling Terminal) 


83B3 (AT&T Selective Calling Terminal) 


Required Parameters 


Optional Parameters 


Device Features 


ADAPTER =TELE1 
ADDRESS = {device-number |(device-number number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number[ number /...) 
TCU = {2701|2702|2703} 


Note: If the telecommunications line connects to a 3705 that is operating 
in emulator mode, specify 2702 or 2703. 


UNIT = 83B3 





OFFLINE = {YES|NO} 
PATH = chpid 
SETADDR = {0|1|2|3} 


Note: If you code TCU =2702, also code the SETADDR parameter. 


STADET = {Y|N} 
TIMEOUT ={Y|N} 
UNITADD = nnn 





None supported. 


4 Trademark of American Telephone and Telegraph Company 
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Unit Record Device Definitions 


This topic explains how to code IODEVICE statements for supported unit record J 
devices. The documentation for each device starts on a new page and includes: 


e Required parameters 

e Optional parameters 

@ Device features (if applicable) 

Devices are arranged in ascending alphanumerical order by device type. The 


heading at the top of each page identifies the class of device, the device type, and 
model. 
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Unit Record 1403-N1, 2, or 7 


1403 Model N1, 2, or 7 Printer 


C 


Required Parameters 


Optional Parameters 


Device Features 


ADDRESS = {device-number |(device-number number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number/[ number /....) 
MODEL = {N1|2|7} 
UNIT = 1403 


FEATURE = feature (See “Device Features.”) 
OFFLINE = {YES|NQO} 

PATH = chpid 

STADET = {Y|N} 

TIMEOUT = {Y|N} 

UNITADD = nan 


code this value 
on the parameter, 


To indicate the presence of this 


feature: FEATURE= 


Universal character set UNVCHSET 


Note: Do not specify this 
feature for the Model 7. 
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Unit Record 2501-B1 or B2 


2501 Model B1 or B2 Card Reader 


Required Parameters 


ADDRESS = {device-number|(device-number ,number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number[ number /....) 
MODEL = {B1|B2} 
UNIT = 2501 





Optional Parameters 


FEATURE = feature (See “Device Features.’’) 
OFFLINE = {YES!NO} 

PATH = chpid 

STADET = {Y|N} 

TIMEOUT = {Y|N} 

UNITADD =nnn 





Device Features 


code this value 
on the parameter, 
To indicate the presence of this 
feature: FEATURE = 


Read in card image mode CARDIMAGE 
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Unit Record 2540-1 


2540 Model 1 Card Read Punch 


C 


Required Parameters 


Optional Parameters 


Device Features 





To define the 2540, code two IODEVICE statements: 


e One to define the reader 
e One to define the punch 


Specify the UNIT = parameter as follows: 


e For the reader specify UNIT =2540R. 
e For the punch specify UNIT =2540P. 


ADDRESS = {device-number|(device-number number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number[ number /....) 
UNIT = {2540R|2540P} 





FEATURE = feature (See “Device Features.’’) 


MODEL =1 

OFFLINE = {YES|NO} 
PATH= chpid 
STADET = {Y|N} 
TIMEOUT ={Y|N} 
UNITADD = nnn 





code this value 
on the parameter, 
To indicate the presence of this 
feature: FEATURE= 


Read or punch in cardimage mode CARDIMAGE 


Note: Specify only if the 2821 
control unit has the 
column-binary feature. 
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Unit Record 3203-5 


3203 Model 5 Printer 
You can define this device as a model 4 or a model 5. ) 


Required Parameters 


ADDRESS = {device-number|(device-number ,number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number{[ number /....) 
MODEL = {4|5} 
UNIT = 3203 





Optional Parameters 


OFFLINE = {YES|NO} 
PATH = chpid 


STADET = {Y|N} 
TIMEOUT ={Y|N} 
UNITADD = nnn 





Device Features 


None Supported. 7 
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3211 Printer 


C 


Required Parameters 


Optional Parameters 


Device Features 


Unit Record 3211 


ADDRESS = {device-number|(device-number number-of-units)} 


Note: The default for number-of-units 1s 1. 


CUNUMBR = (number/[ number /....) 
UNIT = 3211 





OFFLINE = {YES|NO} 
PATH = chpid 


STADET ={Y|N} 
TIMEOUT = {Y|N} 
UNITADD = nnn 





None Supported. 
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Unit Record 3262-5 


3262 Model 5 
MVS/XA supports the 3262-5 as a 4248 printer. J 


Required Parameters 


ADDRESS. = {device-number|(device-number ,number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number[ number ]....) 
UNIT = 4248 


Note: You must define the 3262 model 5 as a 4248 (no model number). 





Optional Parameters 


OFFLINE = {YES|NQ} 
PATH = chpid 


STADET = {Y|N} 
TIMEOUT = {Y|N} 
UNITADD =nnn 





Device Features ; 


None Supported. 
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3505 Card Reader 


Required Parameters 


Optional Parameters 


Device Features 


Unit Record 3505 


ADDRESS = {device-number|(device-number number-of-units)} 


Note: The default for number-of-units 1s 1. 


CUNUMBR = (number/[ number J....) 
UNIT = 3505 


FEATURE = feature (See “Device Features.”) 


OFFLINE = {YES|NO} 
PATH = chpid 
STADET ={Y|N} 
TIMEOUT ={Y|N} 
UNITADD = nnn 


To indicate the presence of this 
feature: 


Read in card image mode 


code this value 








on the parameter, 


FEATURE = 


CARDIMAGE 
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Unit Record 3525 


3525 Card Punch 


Required Parameters 


ADDRESS = {device-number|(device-number number-of-units)} 


Note: The default for number-of-units is 1. 


1 CUNUMBR = (number/[ number /...) 
UNIT = 3525 





Optional Parameters 


FEATURE = (feature/ feature ]...) (See “Device Features.”) 
OFFLINE = {YES|NO} 

PATH =chpid 

STADET = {Y|N} 

TIMEOUT = {¥|N} 

UNITADD =nnn 





Device Features 


code this value 
on the parameter, 
To indicate the presence of this 
feature: FEATURE = 


Column-binary feature CARDIMAGE 


Print feature (Select only one) 
print up to 2 lines per card TWOLINE 
print up to 25 lines per card MULTILINE 
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C 





Unit Record 3800-1, 3, or 8 


3800 Model 1, 3, or 8 Printing Subsystem 


Required Parameters 


Optional Parameters 


Device Features 





ADDRESS = {device-number|(device-number ,number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number{ number /....) 
UNIT = 3800 





FEATURE = (feature/ feature /....) (See “Device Features.”) 


MODEL = {138} 
OFFLINE = {YES|NO} 
PATH = chpid 
STADET ={Y|N} 
TIMEOUT = {Y|N} 
UNITADD = nnn 





code this value 
on the parameter, 
To indicate the presence of this 


feature: FEATURE = 


The burster-trimmer-stacker BURSTER 
feature is installed. 


Character generation 
storage (Select only one) 
Do not specify this 
feature for models 3 or 8. 
1-character 
2-character 
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Unit Record 4245 


4245 Printer 


Required Parameters 


ADDRESS = {device-number|(device-number number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number[ number /....) 
UNIT = 4245 





Optional Parameters 


OFFLINE = {YES|NO} 
PATH =chpid 


STADET = {¥|N} 
TIMEOUT = {Y|N} 
UNITADD =nnn 





Device Features 


None Supported. 
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4248 Printer 


C 


Required Parameters 


Optional Parameters 


Device Features 


Unit Record 4248 


ADDRESS = {device-number|(device-number number-of-units)} 


Note: The default for number-of-units is 1. 


CUNUMBR = (number/[ number /....) 
UNIT = 4248 





OFFLINE = {YES|NO} 
PATH = chpid 
STADET ={Y|N} 


TIMEOUT ={Y|N} 
UNITADD =nnn 





None Supported. 
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Chapter 7. Defining Eligible Device Tables and NIP Consoles 


Fach I/O configuration can define one or more eligible device tables (EDT) and 
must define at least one device that NIP will be allowed to use as a console. 


For each I/O configuration, you can define: 


One EDT with no changes to the device preference table 

One EDT with changes to the device preference table 

Multiple EDTs with or without changes to the device preference tables 
One or more NIP consoles 


Each EDT definition can include: 


e Definitions for one or more esoteric device groups. 
e Changes to the device preference table 
e Names of the generic device types you want to make eligible for VIO 


eS Locating Information in this Chapter 


This chapter contains the following major topics: 


Defining One EDT with No Device Preference Table Changes 7-2 
Defining One EDT with Device Preference Table Changes 7-3 
Defining Multiple EDTs 7-4 

Defining Esoteric Device Groups 7-5 

Identifying VIO-Eligible Generic Device Types 7-7 

Grouping EDT and UNITNAME Statements 7-8 

Defining NIP Consoles 7-9 
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Defining One EDT with No Device Preference Table Changes 


Examples 


To define this EDT, you may either include an EDT statement in the input 
stream or omit it. If you want the EDT identifier to default to the I/O 
configuration identifier (specified on the IOCONFIG statement), omit the EDT 
statement. 


To assign the EDT a specific identifier, code the identifier on the ID= parameter 
of an EDT statement. Place the EDT statement in the input stream immediately 
after the last IODEVICE statement. 


The following input streams illustrate both ways to define this EDT. 


This example shows an input stream with no EDT statement. The MVS 
configuration program assigns the EDT an identifier of 01, the same as the 
I/O configuration identifier. 


IOCONFIG ID=01 
EDs 3s 

CHP UD << 
CNTLUNIT... 
IODEVICE... 


IODEVICE... 
UNITNAME... 


UNITNAME... 
NIPCON... 





This example shows the same input stream but this time it includes an EDT 
statement. This EDT will have an identifier of 02. 


IOCONFIG ID=01 
IDs as 

CHET D:. s% 
CNTLUNIT... 
IODEVICE... 


TODEV ICE. « < 
EDT ID=02 
UNITNAME... 


UNITNAME... 
NIPCON... 
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Defining One EDT with Device Preference Table Changes 


Example 


To define this EDT, include an EDT statement in the input stream. If you want 
the EDT identifier to default to the I/O configuration identifier (specified on the 
IOCONFIG statement), omit the ID= parameter from the EDT statement. To 
assign a specific identifier, specify the identifier on the ID= parameter of the 
EDT statement. 


To change the device order that MVS is to use when attempting to satisfy an 
allocation request, use the DEVPREF= parameter on the EDT statement. When 
MVS attempts an allocation, it attempts to allocate in the order you have 
specified on the DEVPREF= parameter. If the allocation is unsuccessful, MVS 
continues the attempt following the order specified in the IBM-provided device 
preference table. For a description of the IBM-provided device preference table, 
see Appendix B, “IBM Provided Device Preference Table” on page B-1. 


Place the EDT statement in the input stream immediately after the last 
IODEVICE statement. 


The following example defines one EDT and changes the device preference table. 
The EDT identifier defaults to the identifier of the I/O configuration, AO. 


IOCONFIG ID=AO0 
DD) eine 
CHPID.... 
CNTLUNIT.... 
IODEVICE.... 


IODEVICE.... 
EDT DEVPREF=(3375,3380) 
UNITNAME.... 


UNITNAME.... 
NIPCON.... 
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Defining Multiple EDTs 






Note: 






JES3 supports only one EDT per I/O configuration. If a JES3 
installation defines more than one EDT in a configuration, JES3 will 
support only the first EDT defined. 


To define multiple EDTs, include an EDT statement for each EDT. Each EDT 
must have an identifier that is different than all other EDT identifiers. In other 
words, no two EDTs are allowed to have the same identifier. 


To assign the EDT identifier, use the ID = parameter on the EDT statement. 
You may omit the ID= parameter from one (but no more) of the EDT 
statements. If you omit the ID= parameter, the MVS configuration program 
assigns the EDT the same identifier as the I/O contiguration (specified by ID= 
on the IOCONFIG statement). 


To change the device order that MVS is to use when attempting to satisfy an 
allocation request, use the DEVPREF= parameter on the EDT statement. If the 
allocation is unsuccessful, MVS continues the attempt following the order 
specified in the IBM-provided device preference table. For a description of the 
IBM-provided device preference table, see Appendix B, “IBM Provided Device 
Preference Table” on page B-1. 


The topic “Grouping EDT and UNITNAME Statements” on page 7-8 explains 
how to group EDT statements with UNITNAME statements to define multiple 
EDTs. 


Example < 


This example defines three EDTs. 


IOCONFIG ID=Bl1 
TD ieg os 

CHP TDs ee 
CNTLUNI Tvs. 3 
IODEVICE.... 


LODEV ICE e204 
EDT DEVPREF=(4245,1403,3375) 
UNITNAME.... 


UNITNAME.... 
EDT ID=01,DEVPREF=(3330,3380) 
UNITNAME.... 


UNITNAME.... 
EDT ID=02 
UNITNAME.... 


UNITNAME.... 
NIPCON 62-4 
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The first EDT statement omits the ID= parameter and changes the device 
preference table. The identifier of the corresponding EDT will default to Bl. 


The second EDT statement assigns the corresponding EDT an identifier of 01 and 
it also changes the device preference table. 


The third EDT statement assigns an identifier of 02 but does not change the 
device preference table. 


Defining Esoteric Device Groups 


When you define an esoteric device group, you name it and identify the devices 
that the group is to include. You can also make the group eligible for VIO. 


To define an esoteric device group, use the UNITNAME statement. The 
NAME= parameter names the group. The UNIT= parameter specifies the 
device numbers of the devices you want included in the group. If the group 
contains at least one DASD and you want to make the group eligible for VIO, 
code VIO= YES. 


All of the devices that you assign to an esoteric device group must be of the same 
device class with the following exception: you may define esoteric device groups 
that contain devices from both the DASD and magnetic tape device classes. All 
devices that you assign must also be defined on IODEVICE statements. 


After you have defined all of the esoteric device groups for a particular EDT, 
place the UNITNAME statements immediately after the corresponding EDT 
statement. Repeat this procedure, defining esoteric device groups and placing the 
UNITNAME statements immediately after the corresponding EDT statement, 
until you have defined all of the esoteric groups you wish to define. 


Required Esoteric Device Groups 


A number of procedures in the IBM-provided SYS1.PROCLIB refer to the 
esoteric names SYSDA or SYSSQ. If your installation uses these procedures, you 
must define these esoteric device groups to the MVS configuration program. 


The group named SYSSQ must include only magnetic tapes, only direct access 
devices, or both. The group named SYSDA must include direct access devices 


only. 


In addition, your installation might use other cataloged procedures that also refer 
to these or to other esoteric names. 


To determine which esoteric groups your installation uses, review the UNIT = 
parameter on the cataloged procedure DD statements. 


Chapter 7. Defining Eligible Device Tables and NIP Consoles 7-5 


Naming Esoteric Device Groups 


Within a given EDT, no two esoteric device groups can have the same name. An 
esoteric device group in one EDT , however, can have the same name as an 
esoteric device group in another EDT. 


Example 1 
This example contains two esoteric device group definitions. One group, 
GROUPA, is ineligible for VIO (that is the default when you omit the VIO= 
parameter). The other group, GROUPB, 1s eligible for VIO (VIO= YES). 
UNITNAME NAME=GROUPA,UNIT=(210,211) 
UNITNAME NAME=GROUPB, UNIT=(312,414,416) , VIO=YES 
Example 2 


This example illustrates the naming convention that states “An esoteric device 
group in one EDT can have the same name as an esoteric device group in another 
EDT.” In this example, both EDTs define esoteric device groups named SYSSQ, 
SYSDA, and GROUPA. 


IOCONFIG 


EDT 
UNITNAME NAME=SYSDA,... 
UNITNAME NAME=SYSSQ,... 


UNITNAME NAME=GROUPA,... 
UNITNAME NAME=GROUPB,... 
EDT ID=02 

UNITNAME NAME=SYSDA,... 
UNITNAME NAME=SYSSQ,... 
UNITNAME NAME=GROUPA,... 
NIPCON... 
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Identifying VIO-Eligible Generic Device Types 


ye You can identify one or more direct access generic device types that you want to 
make eligible for VIO. You define each generic device type on a UNITNAME 
Statement. 


e Specify the generic name on the NAME= parameter. For a list of 
IBM-defined generic names, see Appendix A, “Generic Device Types” on 
page A-l. 

e Always code VIO= YES. 

e Do not code the UNIT= parameter. 


Place these UNITNAME statements in the input stream with other UNITNAME 
statements following the corresponding EDT statement. If the input stream 
contains no EDT statements, place the UNITNAME statements with other 
UNITNAME statements. 


The following example shows how to code the UNITNAME statement to make 
the generic device type 3350 eligible for VIO. 


UNITNAME NAME=3350,VIO = YES 
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Grouping EDT and UNITNAME Statements 


The following example defines two EDTs and shows how to group corresponding 
UNITNAME statements. 


IOCONFIG ID=A0 
ED seas 
CHP T Diese 
CNTLUNIT.... 


IODEVICE... 


IODEVICE... 


EDT ID=O1 


THE FOLLOWING UNITNAME STATEMENTS DEFINE THE ESOTERIC 
DEVICE GROUPS AND VIO-ELIGIBLE GENERIC DEVICE TYPES 
FOR EDT Ol 


UNITNAME... 
UNITNAME.... 
UNITNAME.... 


EDT ID=02 
THE FOLLOWING UNITNAME STATEMENTS DEFINE THE ESOTERIC 
DEVICE GROUPS AND VIO-ELIGIBLE GENERIC DEVICE TYPES 
FOR EDT Q2 

UNITNAME.... 

UNITNAME.... 

UNITNAME.... 


NIPCON 
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Defining NIP Consoles 


For each I/O configuration, you must define one or more devices that NIP will be 
allowed to use as a console. Figure 7-1 lists the device types and models that you 
can define as NIP consoles. 


Note: To ensure that all system messages appear on one console, define the 
master console as the first available NIP console. 


2740-1 Communications terminai - The terminal must have the 
CHECKING and OIU features and you must specify 
these features. 


Any device that can be defined as a 3270-X. NIP uses 
this device as though it were a 3277-2. 


3277-2 Display station 


3278-2, -2A,- 3, - Display station 
4, or -5 
3279-2A, -2B, Display station 


-2C, -3A, or -3B 
Figure 7-1. Devices That Can be Defined as NIP Consoles 
















3270-X 





















To define a device as a NIP console, code the device number of the device on a 
NIPCON statement. NIP attempts to use the devices in the order they appear on 
the NIPCON statement. If the list of device numbers will not fit on one 
NIPCON statement, use multiple statements. The NIPCON statement is 
described in “NIPCON Statement” on page 5-16. 


Each device number that appears on a NIPCON statement must also be defined 
on an IODEVICE statement. 


Nipcon example: The following example shows how to code the NIPCON 
statement. NIP attempts to use the devices in the order shown, 100, 210, 202, and 
250. Because device number 100 is the first NIP console defined, it should also be 
defined as the master console. 


NIPCON DEVNUM = (100,210,202) 


NIPCON DEVNUM = 250 
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Chapter 8. I/O Configuration Management Tasks 


The tasks in this chapter support the procedures described in 
Chapter 4, “Managing I/O Configurations” on page 4-1. You will do one or 
more of these tasks each time you use those procedures. 


Locating Information in this Chapter 


The chapter contains the following major topics: 


Using SYSGEN Input Statements to Migrate a Configuration 8-1 
Assigning an I/O Configuration Identifier 8-3 

Using the Cataloged Procedure or the SAMPLIB JCL 8-3 
Identifying the SYSIN and JES3 Data Sets 8-12 

Ordering Statements in the Input Stream 8-13 

Selecting the Mode of Operation 8-14 

Invoking the MVS Configuration Program 8-16 

Verifying MVS Configuration Program Output 8-19 


Using SYSGEN Input Statements to Migrate a Configuration 


There are several input statements that you previously used with the SYSGEN 
process that you use as input to the MVS configuration program: 


CHPID 
CNTLUNIT 
ID 
IODEVICE 
UNITNAME 


The MVS configuration program accepts the CHPID, CNTLUNIT, ID, and 
UNITNAME statements without change. 


To determine if changes are required to the IODEVICE statements, read the rest 
of this topic. 
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Migrating a Dummy Device 


It is possible that the SYSGEN input stream will contain IODEVICE statements 
that specify UNIT=DUMMY. If you use these statements and continue to allow 
the UNIT= parameter to specify UNIT=DUMMY, the MVS configuration 
program will define the device as though it were a unit record device. 


Note: When you used the SYSGEN process to define a DUMMY device, you 
could code the DEVTYPE parameter and the ERRTAB parameter on the 
IODEVICE statement. DEVTYPE defined the UCBTYP field; ERRTAB 
identified the error routine to be used for the device. The MVS configuration 
program ignores both of the parameters. 


The MVS configuration program assigns all DUMMY devices: 
e A UCBTYP value of X‘00000800’. 


e Anerror routine value of X‘0D’. The MVS configuration program converts 
this value to an error recovery program (ERP) name of IGEOOOIC. 


e A generic name of DUMMY. 
To define the device as something other than a DUMMY device, you must: 


e Provide a program called a unit information module (UIM) 
e Recode the IODEVICE statement according to the design of the UIM 


The UIM design defines the parameters that you can code on the IODEVICE 
statement including the value that you code for UNIT=. 


For information about coding an IODEVICE statement, see “IODEVICE 
Statement” on page 5-9. For information about coding a UIM and adding it to 
your system, see MV S/Extended Architecture System Programming Library: 
System Modifications. 


Removing Unsupported Parameters 


8-2 


Possibly, some of the IODEVICE statements that you use from the SYSGEN 
input stream will contain parameters that MVS no longer supports. The 
unsupported parameters are AP, DEVTYPE, ERRTAB, EXPBFR, OBRCNT, and 
OPTCHAN. If you allow these parameters to remain, the MVS configuration 
program ignores the parameters and issues informational messages. Otherwise, 
the MVS configuration program works normally. 


To avoid receiving these informational messages, remove any unsupported 
parameters. 
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Assigning an I/O Configuration Identifier 


When you migrate an I/O configuration or define a new I/O configuration, you 
must assign an identifier to the new configuration that the MVS configuration 
program builds. The identifier is a two-character suffix that the MVS 
configuration program appends to the I/O configuration member names: 
IEANCTxx, IOSIITxx, and IOSUCBxx (xx represents the appended suffix). This 
identifier enables installation personnel and MVS to distinguish one configuration 
from another. 


To prevent the MVS configuration program from writing over an existing I/O 
configuration, always assign an identifier that is unused. If you assign an 
identifier that’s currently in use, the MVS configuration program replaces the 
existing configuration with the new configuration, thus destroying the existing 
configuration. 


To assign the identifier, use the ID= parameter on the IOCONFIG statement. 
The IOCONFIG statement is described in “IOCONFIG Statement” on page 5-7. 


IOCONFIG Example: This example assigns an identifier of 00 to a 
configuration. 


IOCONFIG ID=00 


Notes: 


1. If the input stream contains no EDT statement, the MVS configuration program 
assigns the EDT the same identifier as the I/O configuration. 


2. If the input stream contains an EDT statement from which you have omitted the 
ID= parameter, the MVS configuration program assigns the corresponding 
EDT the same identifier as the I/O configuration. 


Using the Cataloged Procedure or the SAMPLIB JCL 


To help you run the MVS configuration program, IBM provides a cataloged 
procedure in a SYS1.PROCLIB member and JCL statements in two 
SYS1.SAMPLIB members. The decision whether to use the cataloged procedure 
or the JCL depends on two factors: 


e The release level of the system on which you run the MVS configuration 
program. 


e The release level of the system on which the I/O configuration will be used. 
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The following table will help you decide whether to use the cataloged procedure 
or the SAMPLIB JCL: 


If you intend to run the MVS Use SYS1.PROCLIB(MVSCP). 
configuration program on an 
MVS/XA release level that is the 
same as the release level on which 
the I/O configuration will be used: 
(for example, you intend to run the 
MVS configuration program on 
MVS/SP2.2.0 to build a 
configuration for MVS/SP2.2.0), 


If you intend to run the MVS 
configuration program on an earlier 
MVS/XA release level than the 
release level on which the I/O 
configuration will be used: 

(for example, you intend to run the 
MVS configuration program on 
MVS/SP2.1.0 to build a 
configuration for MVS/SP2.2.0), 


If you intend to run the MVS 
configuration program on 
MVS/370, 





















See “SYS1.PROCLIB(MVSCP) 
Cataloged Procedure.” 





















Use SYS1.SAMPLIB(MVSCPXA),. 











See “SYS1.SAMPLIB(MVSCPXA) 
JCL Statements” on page 8-6. 


















Use SYS1.SAMPLIB(MVSCP370). 









See “SYS1.SAMPLIB(MVSCP370) 
JCL Statements” on page 8-9. 





SYS1.PROCLIB(MVSCP) Cataloged Procedure J 


The IBM-provided cataloged procedure contains the following JCL statements: 


/ /MVSCP PROC TYPE='VALIDATE' ,DEFDATA=!'',JES3='NULLFILE' 

/ /MVSCP EXEC PGM=CBPMVSCP,PARM='&TYPE' 

//SYSPRINT DD SYSOUT=* , DCB= (RECFM=FBA, LRECL=80 , BLKSIZE=1600) 
//SYSIN DD DSN=&DEFDATA,DISP=SHR 

//SYSLMOD DD DSN=SYS1.NUCLEUS , DISP=SHR 

//SYSLIB DD DSN=SYS1.MACLIB,DISP=SHR 

//SYSUT1 DD UNIT=SYSDA,SPACE=(TRK, (15,10) ) 

//SYSUT2 DD UNIT=SYSDA, SPACE=(TRK, (15,10) ) ,DCB=(RECFM=FB,LRECL=80, 
ff BLKSIZE=1680) 

//SYSUT3 DD UNIT=SYSDA,SPACE=(TRK, (30,10) ) 

//SYSASMP DD SYSOUT=* 

//SYSLOUT DD SYSOUT=* 

//SYSLKEDP DD SYSOUT=* 

//SYSRPT DD SYSOUT=* , DCB= (RECFM=FBA, LRECL=133,BLKSIZE=2926) 
//SYSJES3 DD DSN=&JES3 , DISP=SHR 





Figure 8-1. Cataloged Procedure JCL in SYS1.PROCLIB(MVSCP) 
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The PROC statement contains three parameters: 


e TYPE®= specifies the mode of operation. The default is VALIDATE. For 
information about the purpose of each mode, see “Selecting the Mode of 
Operation” on page 8-14. 


e DEFDATA@= specifies the name of the input data set. That is the data set 
that contains the input statements. You must always specify the data set 
name. 


e JES3= specifies the name of the data set where the MVS configuration 
program is to write the data for the JES3 initialization stream checker. 
Specify this name only if you want this output written. The default is 
NULLFILE (no output is written). 


To accommodate devices with different output widths, override the LRECL 
parameter on the SYSPRINT DD statement. Valid LRECL values are in the 
range 80 to 255. The LRECL value determines the format of MVS configuration 
program messages. 


BLKSIZE be an even multiple of LRECL. Therefore, if you change LRECL, you 
may also have to change BLKSIZE. 


The following table explains the use of the data sets that the cataloged procedure 
allocates. 


How the Data Set is Used 


SYSPRINT Contains messages issued by the MVS configuration program. 
SYSIN Contains the MVS configuration program input statements. 


SYSLMOD Contains the I/O configuration built by the MVS configuration program. (This 
is the linkage editor SYSLMOD file). 


SYSLIB Contains the MVS configuration program parsing macros. (This is the 
assembler SYSLIB file). 


SYSUT1 Used by the assembler and the linkage editor as a work file. 


SYSUT2 The MVS configuration program, before processing the input stream, writes the 
input stream to this file. The file then becomes the assembler SYSIN file. 


SYSUT3 This file serves several purposes: 
@ It is the assembler SYSPUNCH file: the assembler writes its output to this 
file which then becomes the loader SYSLIN file. 
It is the linkage editor SYSLIN file: the MVS configuration program 
writes the I/O configuration object modules to this file which then becomes 
the linkage editor SYSLIN file. 


SYSASMP Contains the listing written by the assembler. (This is the assembler SYSPRINT 
file.) 

SYSLOUT Contains messages issued by the loader. (This is the loader SYSLOUT file.) 
The loader writes this file only when the MVS configuration program runs in 
DEBUG mode. 

SYSLKEDP Contains linkage editor diagnostic output. (This is the linkage editor 
SYSPRINT file.) The linkage editor writes this file only when the MVS 
configuration program runs in IODEF mode or EDT mode. 


SYSRPT Contains the MVS configuration program reports: 


@ The IOS report. 
@ The allocation report. 
@ The NIP report. 


SYSJES3 Contains data, written by the MVS configuration program, that will be read by 
the JES3 initialization stream checker. 


Figure 8-2. How the MVS Configuration Program Uses the Data Sets 
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SYS1.SAMPLIB(MVSCPXA) JCL Statements 


To run the MVS configuration program on an earlier MVS/XA release level than J 
the release level on which the I/O configuration will be used, use the 

SYS1.SAMPLIB(MVSCPXA) JCL. The SAMPLIB JCL contains the same DDs 

as the cataloged procedure (the use of the data sets allocated by those DDs is 

explained in Figure 8-2 on page 8-5) plus a STEPLIB DD that defines the 

SYS1.LINKLIB data set. The SYS1.LINKLIB data set must contain MVS 

configuration program modules that are at the same release level as the system on 

which the I/O configuration will be used. 


Before using the SAMPLIB JCL, however, you must modify some of the JCL 


statements. For instructions on how to modify those statements, see “Modifying 
SYS1.SAMPLIB(MVSCPXA) JCL” on page 8-8. 


Jf OR RA Re RRS ARMOR, Dee NN tes OR Re RIS I Ae I II AR Ie Ae RR RR RR Ae ee A RE A ee Re Ie Oe Ae ee 


di * 
//* THIS JCL SHOULD BE USED TO RUN THE MVSCP ON AN EARLIER MVS/XA * 
//* RELEASE LEVEL THAN THE LEVEL ON WHICH THE I/O CONFIGURATION * 
//* WILL BE USED. * 
Va fa! * 
//* IF YOU ARE RUNNING THE MVSCP ON AN MVS/XA RELEASE LEVEL THAT * 
//* IS THE SAME AS THE RELEASE LEVEL ON WHICH THE I/O CONFIGURATION * 
//* WILL BE USED, THEN USE THE CATALOGED PROCEDURE THAT IS IN * 
//* SYS1.PROCLIB(MVSCP) . * 
7 7* * 
//* IF YOU ARE RUNNING THE MVSCP ON AN MVS/370 SYSTEM, THEN USE THE * 
//* SBMPLE JCL IN SYS1.SAMPLIB(MVSCP370) . * 

* 

* 


* 
ff ERR EER RE RR IR Raa RR OR RR ee ek ae Oe Le RU ee a ee a er ee Ok ee a ae ee 
/ /MVSCP JOB » 


ff REAR ERE ERE RE LES NR I SR RIS RR RNR, OR IR, ROM IS ete RR ee Pee ee Rae ee Re Rte 


ff* * 
//* THE MVSCP INPUT PARAMETER STRING MUST BE SPECIFIED ON THE * 
//* EXEC STATEMENT. SET THE PARM TO 'IODEF' IN ORDER TO BUILD AN * 
//* 1/0 CONFIGURATION. * 
Ve hoa * 
LAN LS RR RR RN HSE A RR eR RO RR Ree Me LO I BS Re se I OR ARR A RR eR a ae Oe 
/ /MVSCP EXEC PGM=CBPMVSCP, PARM='VALIDATE' 

Jf EEE EIR TNR DL IS RRR AG MORRIS RRs Re Peete Me We Nt ee Ae A Nee we Me gee RID ee MR Rey ee ee RI ROS Ae Oe 
ip 


* 
//* THE SYS1.LINKLIB DATASET ON THE STEPLIB DD STATEMENT MUST * 
//* BE THE SYS1.LINKLIB FOR THE SYSTEM THAT WILL USE THE 1/0 * 
//* CONFIGURATION. THIS SYS1.LINKLIB DATASET CONTAINS THE CORRECT * 
//* VERSION OF THE MVSCP MODULES. * 
//* * 
//* THE APPROPRIATE UNIT AND VOLSER FOR THE SYS1.LINKLIB * 
//* DATASET MUST BE SPECIFIED ON THE STEPLIB DD STATEMENT. * 

* 

* 


x 
Oh mibntaenereig cara eutancauns Sateauii canton wcatdictaen cannes sone 
//STEPLIB DD DSN=SYS1.LINKLIB,DISP=SHR, 
UNIT=XXXX , VOL=SER=XXXXXX 
//SYSPRINT DD SYSOUT=* , DCB= (RECFM=FBA,LRECL=80, BLKSIZE=1600) 


Figure 8-3 (Part 1 of 2). JCL Statements in SYS1.SSAMPLIB(MVSCPJCL) 
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J [RRR RRR RRR RRR RK RR RK RR RK RRR KR RIOR KR IRR IR ORK RR OK RK ITO RR IT RK KH IK 
//* * 
//* THE INPUT I/O DEFINITION DATASET MUST BE SPECIFIED ON THE x 
//*  SYSIN DD STATEMENT. THIS IS THE DATASET THAT CONTAINS YOUR * 
//*  IODEVICE AND UNITNAME STATEMENTS. * 
* * 

* 


f PERE ST IR ROR INE RTI IR MI A IR RNS ee We OS A RR RNR RIN Rin eR eR eRe ne oe 


//SYSIN DD DSN=XXXXXXXX,DISP=SHR 
TBR RRO RII III IOI ITO IIT TO I TOI ITI IOI TOO TORR IOI KIC 


SYSLMOD MUST POINT TO THE SYS1.NUCLEUS DATASET FOR THE SYSTEM 
THAT WILL USE THE I/O CONFIGURATION. 


* 
* 
* 
* 
SYSLIB MUST POINT TO THE SYS1.MACLIB DATASET FOR THE SYSTEM * 
THAT WILL USE THE I/O CONFIGURATION. 
* 
* 
* 
* 
* 


THE APPROPRIATE UNIT AND VOLSER MUST BE SPECIFIED ON THE 
SYSLMOD AND SYSLIB DD STATEMENTS. 


PEEL ATE ATER IE Re RL Me ee, Re Roe Ne, te ee Pe ee ees ee Pe ON Ne DO RY OR ae Re Pee, ee ea 


//SYSLMOD DD DSN=SYS1.NUCLEUS,DISP=SHR, 

va UNIT=XXXX , VOL=SER=XXXXXX 

//SYSLIB DD DSN=SYS1.MACLIB,DISP=SHR, 

a UNIT=XXXX , VOL=SER=XXXXXX 

A/SYSUT A DD UNIT=SYSDA,SPACE=(TRK, (15,10) ) 

//SYSUT2 DD UNIT=SYSDA,SPACE=(TRK, (15,10) ) ,DCB=(RECFM=FB,LRECL=80, 
BLKSIZE=1680) 

//SYSUT3 DD UNIT=SYSDA,SPACE=(TRK, (30,10) ) 

//SYSASMP DD SYSOUT=* 

//SYSLOUT DD SYSOUT=* 

//SYSLKEDP DD SYSOUT=* 


//SYSRPT DD SYSOUT=* , DCB= (RECFM=FBA , LRECL=133 , BLKSIZE=2926) 
Lf ERE LR LRA A Te ee ay aN ee LCM noe Mee LR Wee ie NON ae a OS De DOME IA MR A Rea Re 


//* * 
//* IF THE JES3 INITIALIZATION STREAM CHECKER DATA IS DESIRED, * 
THEN THE OUTPUT DATASET FOR THE JES3 INITIALIZATION STREAM i 
CHECKER DATA MUST BE SPECIFIED ON THE SYSJES3 DD STATEMENT. * 
OTHERWISE, THE SYSJES3 DD STATEMENT MUST SPECIFY A DATASET * 
NAME OF "NULLFILE". bd 

* 

x 


LREEERE AREER ERA LER AER REA RAE RA SR Re RRL ER A Re ee eR RR Re eek 


//SYSJES3 DD DSN=NULLFILE,DISP=SHR 





Figure 8-3 (Part 2 of 2). JCL Statements in SYS1.SAMPLIB(MVSCPJCL) 
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Modifying SYS1.SAMPLIB(MVSCPXA) JCL 


Comment statements throughout the SAMPLIB JCL identify changes that you 
must make in order to use the JCL statements. The following table summarizes 
those changes: 


JCL Statement Description and Changes Required 


//[MVSCP EXEC The PARM = parameter, as coded in the sample, 
selects VALIDATE mode. To select another mode, 
change the PARM = parameter. 

For example, to select IODEF mode, code 
PARM =‘IODEF’. 


//STEPLIB DD Specify the UNIT= and VOL= parameter values. 
This DD statement must identify the SYS1.LINKLIB 
data set that contains the level of the MVS 
configuration program that corresponds to the level of 
the system on which the I/O configuration will be used. 
For example, if you are going to use the configuration 
on MVS/SP2.2.0, this DD must identify the 
SYS1.LINKLIB that contains the MVS/SP2.2.0 level 
of the MVS configuration program. 


//SYSIN DD Specify the DSN= parameter value. You must specify 
the name of the data set that contains the MVS 
configuration program input statements. 


//SYSLMOD DD Specify the UNIT= and VOL= parameter values. 
This DD must identify the data set where the MVS 
configuration program is to write the I/O 
configuration, that is, the SYS1.NUCLEUS data set of 
the system on which the configuration will be used. 


//SYSLIB DD Specify the UNIT= and VOL= parameter values. 
This DD statement must identify the SYS1.MACLIB 
of the system on which the configuration will be used. 
For example, if you intend to use this configuration on 
MVS/SP2.2.0, the DD statement must identify the 
MVS/SP2.2.0 level of SYS1.MACLIB. 

//SYSJES3 DD If you want the MVS configuration program to write 
data that will be read by the JES3 initialization stream 
checker, specify, on the DSN= parameter, the name of 
the data set where you want the data to be written. 
Otherwise, ignore this DD statement. 
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SYS1.SAMPLIB(MVSCP370) JCL Statements 


.. To run the MVS configuration program on MVS/370, use the 
SYS1.SAMPLIB(MVS8370) JCL. The SAMPLIB JCL contains the same DDs as 
the cataloged procedure (the use of the data sets allocated by those DDs is 
explained in Figure 8-2 on page 8-5) plus a STEPLIB DD that defines 
concatenated SYS1.LINKLIB data sets, a SYSUT4 DD, and a SYSUTS DD. 


The first STEPLIB DD must define the SYS!1.LINKLIB that contains the 
MVS/370 system modules. The second STEPLIB DD must define the 
SYS1.LINKLIB that contains MVS configuration program modules that are at 
the same release level as the system on which the I/O configuration will be used. 


Before using the SAMPLIB JCL, however, you must modify some of the JCL 
statements. For instructions on how to modify those statements, see “Modifying 
SYS1.SAMPLIB(MVSCP370) JCL Statements” on page 8-11. 


ff PPE AAEE REE REALE LA ERAS EA SEE AREAL ARLE ERS RAE Oe ee ee 


THIS JCL SHOULD BE USED TO RUN THE MVSCP ON AN MVS/370 SYSTEM. 


IF YOU ARE RUNNING THE MVSCP ON AN EARLIER MVS/XA RELEASE 
LEVEL THAN THE LEVEL ON WHICH THE 1/0 CONFIGURATION WILL BE 
USED, THEN USE THE SAMPLE JCL IN SYS1.SAMPLIB(MVSCPXA). 


IF YOU ARE RUNNING THE MVSCP ON AN MVS/XA RELEASE LEVEL THAT 
IS THE SAME AS THE RELEASE LEVEL ON WHICH THE I/0 CONFIGURATION 
WILL BE USED, THEN USE THE CATALOGED PROCEDURE THAT IS IN 

( SYS1.PROCLIB(MVSCP). 


* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 


Lf Re TREES REAAER EEA ERE ES SEL ER Le Ne RNR EN RRS RRR Re eR RAR ee Ree ee 


/ /MVSCP JOB 
ff REERERERLERERERELE AREA RA AERA REE REEL RARE ED RNS RM A Re RNR RRS 


De fas * 
//* THE MVSCP INPUT PARAMETER STRING MUST BE SPECIFIED ON THE * 
//* EXEC STATEMENT. SET THE PARM TO 'IODEF' IN ORDER TO BUILD AN * 
//* 1/0 CONFIGURATION. * 
ye * 

* 


EL REEL AL AEE EERAA LALA ELE REESE SE SEERA ELE SARE LAAN A See A ee ee 


//MVSCP EXEC PGM=CBPMVSCP,PARM='!VALIDATE' 
J [RRR RIKKI RR KR RIK IR KR KK IK IR IR KR IR KR RK IR IK IR IORI RIOR KR RK KIRK RR KK 


THE FIRST SYS1.LINKLIB DATASET ON THE STEPLIB DD STATEMENT 

IS THE SYS1.LINKLIB FOR THE SYSTEM ON WHICH THIS JCL IS BEING 
RUN. THIS SYS1.LINKLIB DATASET CONTAINS THE MVS/370 VERSION 
OF THE LOADER. 


* 
* 
* 
* 
* 
* 
THE SECOND SYS1.LINKLIB DATASET ON THE STEPLIB DD STATEMENT 
MUST BE THE SYS1.LINKLIB FOR THE SYSTEM THAT WILL USE THE I/O * 
CONFIGURATION. THIS SYS1.LINKLIB DATASET CONTAINS THE CORRECT 
VERSION OF THE MVSCP MODULES. * 
* 
* 
* 
* 
* 


THE APPROPRIATE UNIT AND VOLSER FOR THE SECOND SYS1.LINKLIB 
DATASET MUST BE SPECIFIED ON THE STEPLIB DD STATEMENT. 


Jf RRERRERRKKREKEEREKRE KER KEKE KERR KR ER ERR RK ER RR ER ERE KEKE KR KEEEKEKEKKEEKKEKRKEKKEE 





é Figure 8-4 (Part 1 of 2). JCL Statements in SYS1.SAMPLIB(MVSCP370) 
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J/7/STERLLS: “DD DSN=SYS1.LINKLIB,DISP=SHR 


voy DD DSN=SYS1.LINKLIB,DISP=SHR, 
vey UNIT=XXXX , VOL=SER=XXXXXX 
//SYSPRINT DD SYSOUT=* , DCB= (RECFM=FBA,LRECL=80 , BLKSIZE=1600) 


ff PRI OR ERR ONE RR Re Re De Re Ae RR RI Te DIR RN Bet OE De Dee Re Oe De Re Rte tee eRe Re eee ee Pe 


fp * 
//* THE INPUT I/O DEFINITION DATASET MUST BE SPECIFIED ON THE * 
//* SYSIN DD STATEMENT. THIS IS THE DATASET THAT CONTAINS YOUR * 
//*  IODEVICE AND UNITNAME STATEMENTS. * 
a = 
Ye EIT EAST RI Re RNR DS TIS Ie A ON Re eee Oe Ae Ne Pee ee Re Ae RO ane Re er we Pee oe RO Ne ee eek Met ae) ae ae 
//SYSIN DD DSN=XXXXXXXX, DISP=SHR 
ff REA ERA RIE LR SI RS RR Re RR RR ee BO RRR ee RN tee Me eee ee nae Oe 
eas - 
//* SYSLMOD MUST POINT TO THE SYS1.NUCLEUS DATASET FOR THE SYSTEM * 
//* THAT WILL USE THE I/O CONFIGURATION. * 
eae . 
//*  SYSLIB MUST POINT TO THE SYS1.MACLIB DATASET FOR THE SYSTEM * 
//* THAT WILL USE THE I/O CONFIGURATION. * 
we as * 
//* THE APPROPRIATE UNIT AND VOLSER MUST BE SPECIFIED ON THE * 
//* SYSLMOD AND SYSLIB DD STATEMENTS. * 
Jf * 
ff BREET RRR ILA IIS BTS PBR IIS DI Te Me BS RIE TO RST We De IR We Mee Pe ee MeN REIS SRE TSR RGIS Be Pe eae Me eS ee Denes, ec 
//SYSLMOD- DD DSN=SYS1.NUCLEUS ,DISP=SHR, 

UNIT=XXXX , VOL=SER=XXXXXX 
//SYSLIB DD DSN=SYS1.MACLIB,DISP=SHR, 

UNIT=XXXX , VOL=SER=XXXXXX 
//SYSUTL DD UNIT=SYSDA,SPACE=(TRK,(15,10)) 
//SYSUT2 DD UNIT=SYSDA,SPACE=(TRK,(15,10)) ,DCB=(RECFM=FB,LRECL=80, 
J7 BLKSIZE=1680) 
//SYSUT3 DD UNIT=SYSDA,SPACE=(TRK, (30,10) ) 
//SYSUT4 DD UNIT=SYSDA,SPACE=(TRK, (15,10) ) 
J/SYSULS DD UNIT=SYSDA,SPACE=(TRK, (15,10) ) 
//SYSASMP DD SYSOUT=* 
//SYSLOUT DD SYSOUT=* 
//SYSLKEDP DD SYSOUT=* 
//SYSRPT DD SYSOUT=* , DCB= (RECFM=FBA , LRECL=133 , BLKSIZE=2926) 
ff ERE ELA RL AIR BAR IR ER te BR ete eee eA Ae eee ot RRS, Ae Par tO ter IRIS arent Way IO OG Tea Pe 
a Ags 


* 
//* IF THE JES3 INITIALIZATION STREAM CHECKER DATA IS DESIRED, * 
//* THEN THE OUTPUT DATASET FOR THE JES3 INITIALIZATION STREAM * 
//* CHECKER DATA MUST BE SPECIFIED ON THE SYSJES3 DD STATEMENT. * 
//* OTHERWISE, THE SYSJES3 DD STATEMENT MUST SPECIFY A DATASET * 
//* NAME OF "“NULLFILE". * 
k * 

* 


YEP A I Pe Ree TEIN We tas Bey aR oe Fe ee we Ae Penton rO ge ee ae Nee RCI ete Dede te Mea De eee Rete Gee OS) Lede ON em Rte ee RN 


//SYSJES3 DD DSN=NULLFILE,DISP=SHR 


Figure 8-4 (Part 2 of 2). JCL Statements in SYS1.SAMPLIB(MVSCP370) 
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Modifying SYS1.SAMPLIB(MVSCP370) JCL Statements 


Comment statements throughout the SAMPLIB JCL identify changes that you 
must make in order to use the JCL statements. The following table summarizes 
those changes: 


JCL Statement Description and Changes Required 

/[MVSCP EXEC The PARM= parameter, as coded in the sample, 
selects VALIDATE mode. To select another mode, 
change the PARM= parameter. 

//STEPLIB DD 
SYS1.LINKLIB that contains the MVS/SP2.2.0 level 
of the MVS configuration program. 

//SYSIN DD Specify the DSN= parameter value. You must specify 
the name of the data set that contains the MVS 
configuration program input statements. 


//SYSLMOD DD Specify the UNIT= and VOL= parameter values. 


This DD must identify the data set where the MVS 
//SYSLIB DD 


configuration program is to write the I/O 
//SYSJES3 DD 















For example, to select IODEF mode, code 
PARM = ‘IODEF’. 


Specify the UNIT= and VOL= parameter values on 
the second STEPLIB DD. This DD statement must 
identify the SYS1.LINKLIB data set that contains the 
level of the MVS configuration program that 
corresponds to the level of the system on which the I/O 
configuration will be used. 






















For example, if you are going to use the configuration 
on MVS/SP2.2.0, this DD must identify the 










configuration, that 1s, the SYS1.NUCLEUS data set of 
the system on which the configuration will be used. 












Specify the UNIT= and VOL= parameter values. 
This DD statement must identify the SYS1.MACLIB 
of the system on which the configuration will be used. 


For example, if you intend to use this configuration on 
MVS/SP2.2.0, the DD statement must identify the 
MVS/SP2.2.0 level of SYS1.MACLIB. 


If you want the MVS configuration program to write 
data that will be read by the JES3 initialization stream 
checker, specify, on the DSN= parameter, the name of 
the data set where you want the data to be written. 
Otherwise, ignore this DD statement. 
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Identifying the SYSIN and JES3 Data Sets 


The SYSIN data set contains the input statements that define your I/O 
configuration. This required data set is defined by the //SYSIN DD statement in 
both the IBM-provided cataloged procedure and the IBM-provided SAMPLIB 
JCL. 


The JES3 data set is required only if you want the MVS configuration program to 
write data that can be read by the JES3 initialization stream checker. The 
//SYSJES3 DD statement in both the IBM-provided cataloged procedure and the 
IBM-provided SAMPLIB JCL defines the JES3 data set. 


SYSIN Data Set 


Each time you invoke the MVS configuration program, you must specify the 
name of the SYSIN data set. There is no default for this name. 


If you use the IBM-provided cataloged procedure, specify the SYSIN data set 
name on the DEFDATA parameter of the PROC statement. 


If you use the IBM-provided SAMPLIB JCL, specify the SYSIN data set name 
on the DSN= parameter of the SYSIN DD statement. 


JES3 Data Set 


The JES3 data set is optional. Specify its name only 1f you want the MVS 
configuration program to write data that the JES3 initialization stream checker 
can read. The default name is NULLFILE which causes no data to be written. 


Note: The JES3 data will be written only if: 


e You specify the name of the JES3 data set. 
e You select either IODEF mode or EDT mode. 
e The MVS configuration program detects no errors during execution. 


If you use the IBM-provided cataloged procedure and wish to specify the JES3 
data set name, use the JES3 parameter on the PROC statement. 


If you use the IBM-provided SAMPLIB JCL and wish to specify the JES3 data 
set name, use the DSN parameter on the SYSJES3 DD statement. 


The MVS configuration program can write the JES3 data to either a sequential 
data set or to a member of a partitioned data set. JES3, however, requires that 
the data be in a partitioned member. JES3 also requires that the member name 
be the same as the processor name defined in the JES3 initialization stream. For 
additional information about how JES3 uses this data set, see MV S/Extended 
Architecture: System Programming Library: JES3 Initialization and Tuning. 
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Ordering Statements in the Input Stream 


To provide an order to the input stream, IBM recommends that you group the 
statements as shown in the following example. 


IOCONFIG 
ID 

CHPID 
CNTLUNIT 
IODEVICE 


IODEVICE 
EDT 
UNITNAME 


UNITNAME 
NIPCON 


Note: Do not include an END statement in the input stream. An END statement 
causes the MVS configuration program to abnormally terminate. 





This grouping offers these advantages: 
e The I/O configuration identifier appears on the first statement. This might 
make it easier to locate a specific configuration. 


e The IOCP statements are grouped together as are the IODEVICE statements. 
This grouping might make it easier to locate specific statement types when 
you edit the input stream. 


Required Order for EDT and UNITNAME Statements 


The only statements that must appear in a specific order are the EDT statements, 
and UNITNAME statements. 


One Eligible Device Table 
If you define only one eligible device table, you can either include or omit the 
EDT statement. If you include an EDT statement, place it ahead of all 
UNITNAME statements. If you omit the EDT statement, IBM recommends you 
place all UNITNAME statements after the last IODEVICE statement. 

Multiple Eligible Device Tables 
If you define multiple eligible device tables in one input stream, include one EDT 


statement for each eligible device table. Place each EDT statement immediately 
ahead of the UNITNAME statements that correspond to that eligible device table. 
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Selecting the Mode of Operation 


Migrate an 1/O configuration 
from an earlier MVS system. 


Update an existing I/O 
configuration by adding, 
deleting, or changing one or 
more of the following 
statements: 


IOCONFIG 
IODEVICE 
EDT 
UNITNAME 
NIPCON 


Note: If you add, delete, or 
change EDT or 
UNITNAME statements 
only, you can select EDT 
mode instead of IODEF 
mode. In EDT mode, the 
MVS configuration program 
replaces only the affected 
EDT members of the 
configuration. In IODEF 
mode, the MVS 
configuration program 
replaces all configuration 
members. 


Update an existing 
configuration by adding, 
deleting, or changing one or 
more of the following 
statements: 


@ EDT 
@ UNITNAME 


Note: If you change any 
other statements, you must 
select IODEF mode. 


Figure 8-5 (Part 1 of 2). 


The MVS configuration program has four modes of operation: IODEF, EDT, 
VALIDATE (the default), and DEBUG. 


The mode you select will depend on what you want to do. Use the following 
decision table to determine the mode to select. 


To do this task: | Select The MVS Configuration Program Will: 


IODEF | 


Validity check the input statements and issue error messages for detectable 
errors. 


If execution is successful, writes new I/O configuration members, issues 
reports, and optionally writes configuration data for use by the JES3 
initialization stream checker. 


Validity check the input statements and issue error messages for detectable 
errors. 


If execution is successful, replaces the existing I/O configuration members, 
issues reports, and optionally writes configuration data for use by the JES3 
initialization stream checker. 


Validity check the input statements and issue error messages for detectable 
errors. 


If execution is successful, replaces the affected EDT members of the 
configuration, issues reports, and optionally writes configuration data for 
use by the JES3 initialization stream checker. 





Selecting the Mode of Operation 
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To do this task: The MVS Configuration Program Will: 


Validity check the input statements and issue error messages for detectable 


IODEF 
errors. 
If execution is successful, writes new I/O configuration members, issues 
reports, and optionally writes configuration data for use by the JES3 
initialization stream checker. 
VALIDATE Validity check the input stream and issue error messages for detectable 
errors, 
@® Issue the same reports that are issued in IODEF mode. 
Note: The MVS configuration program does not build an I/O configuration. 


Define a new I/O 
configuration, 


Validity check input 
statements without creating 
or updating a configuration, 


Gather information to debug 
any of the following 
problems: 


@ The assembler parsing 
macros are generating 
incorrect code 


The loader is having 
problems loading 
records 


EDT problems 


The MVS configuration 
program ESTAE its 
masking a problem 
(ESTAE coverage is 
disabled in DEBUG 
mode, thus it cannot 
mask the problem) 


Figure 8-5 (Part 2 of 2). 





DEBUG @ Validity check the input statements and issue messages for detectable errors. 
@® Write the assembler text records, loader output, and certain MVS 
configuration program control blocks data sets. 
Note: The MVS configuration program does not build the I/O configuration. 


Selecting the Mode of Operation 


How you select the mode depends on whether you use the IBM-provided catalog 
procedure or the IBM-provided SAMPLIB JCL. 


If you use the cataloged procedure, select the mode by using the TYPE = 


parameter on the PROC statement. 


If you use the SAMPLIB JCL, select the mode by using the PARM= 
parameter on the EXEC statement. 
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Invoking the MVS Configuration Program 


J 


There are two ways to invoke the MVS configuration program, dynamically or 
with JCL statements. 


JCL Invocation 


If you are using the IBM-provided SAMPLIB JCL, modify the JCL and then 
submit it as you would any other job. 


To invoke the MVS configuration program through the IBM-provided cataloged 
procedure, use JCL similar to that shown in the following example. For 
information on how to use the invocation JCL to override statements in the 
cataloged procedure, see MV S/Extended Architecture JCL. 


/ /MVSCP JOB 'ACCTINFO','NAME',MSGLEVEL=(1,1), 
di MSGCLASS=R, REGION=4096K 
//TEST EXEC PROC=MVSCP,TYPE='IODEF', 


// DEFDATA='INSTALL.IODEF', 
a JES3='INSTALL.JES3.DATA' 





Dynamic Invocation 
To dynamically invoke the MVS configuration program, your program can either ) 
issue the ATTACH macro or the LINK macro. The entry point name of the 
MVS configuration program is CBPMVSCP. 

Register Content 


Upon entry into CBPMVSCP, the registers must contain the following: 


Register Content 

RO Any value 

Rl The address of a two-word parameter list 
R2 - R12 Any value 

R13 The address of an 18-word register save area 
R14 The return address 

R15 The entry point address of CBPMVSCP 


Parameter List 


The two-word parameter list pointed to by register 1 must start on a fullword 
boundary. The list must contain: 


word 1 A pointer to a variable length required options list. 


word 2 A pointer to an optional list of alternate DD names. If 
you omit the list of alternate DD names, this pointer 


must contain binary 0. ‘ } 
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Options List 


Alternate DD Names List 


This list, pointed to by word 1, must start on a halfword boundary that is not 
also a fullword boundary. 


The first two bytes must contain a binary count of the number of bytes in the 
rest of the list. 


The rest of the list must identify the MVS configuration program option that 
is to be used. You can identify only one option per invocation. Valid values, 
which must be in character string format, are: 


IODEF 
EDT 
VALIDATE 
DEBUG 


If used, this optional list, pointed to by word 2, must start on a halfword 
boundary that is not also a fullword boundary. 


The first two bytes must contain a binary count of the number of bytes in the 
rest of the list. 


The rest of the list specifies alternate DD names that you wish to use in place 
of the standard DD names. For a list of standard DD names, see “Standard 
DD Name List” on page 8-18. 


DD names in the alternate list must appear in the same sequence as they 
appear in the standard list. 


Each name must be eight characters long. If a name contains fewer than 
eight characters, pad it with blanks. 


If you omit an alternate DD name, set that entry in the alternate DD 
names list to binary 0. 


Entrys in the alternate DD name list that correspond to empty entrys in 
the standard DD name list must be set to binary 0. 
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Standard DD Name List 


The standard DD names list contains the following DD names in the order 2 
shown. Each entry, or slot, is eight bytes long. Names are left justified, and if 
shorter than eight bytes, padded with blanks. Empty slots contain binary 0. 


Empty slot. 
Empty slot. 


SYSLMOD Contains the I/O configuration built by the MVS configuration program. (This 


is the linkage editor SYSLMOD file.) 


SYSLIB Contains the MVS configuration program parsing macros. (This is the 
assembler SYSLIB file.) 


SYSIN Contains the MVS configuration program input statements. 






















SYSPRINT Contains messages issued by the MVS configuration program. 
fo Empty slow 
SYSUTI Used by the assembler and the linkage editor as a work file. 


SYSUT2 The MVS configuration program, before processing its input stream, writes the 
input stream to this file. The file then becomes the assembler SYSIN file. 
Empty slot 


SYSUT3 










This file serves several purposes: 


@ It is the assembler SYSPUNCH file: the assembler writes its output to this 
file which then becomes the loader SYSLIN file. 






It is the linkage editor SYSLIN file: the MVS configuration program 
writes the I/O configuration object modules to this file which then becomes 
the linkage editor SYSLIN file. 











Empty slot 
Empty slot 


SYSASMP Contains the listing written by the assembler. (This is the assembler SYSPRINT 
file.) 


SYSLOUT Contains messages issued by the loader. (This is the loader SYSLOUT file.) 
The loader writes this file only when the MVS configuration program runs in 
DEBUG mode. 

SYSLKEDP 
@ = The allocation report. 


Contains linkage editor diagnostic output. (This is the linkage editor 
SYSRPT 
@ The NIP report. 


SYSPRINT file.) The linkage editor writes this file only when the MVS 
SYSJES3 Contains data, written by the MVS configuration program, that will be read by 
the JES3 initialization stream checker 

















Contains the MVS configuration program reports: 








@ = The IOS report. 






configuration program runs in IJODEF mode or EDT mode. 
SYSUT4 The assembler SYSUT2 workfile. Used only if you execute the MVS 
configuration program on MVS/370. 
SYSUTS The assembler SYSUTS workfile. Used only if you execute the MVS 
configuration program on MVS/370. 
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Verifying MVS Configuration Program Output 


After the MVS configuration program executes, check for successful execution by 
verifying the output. To verify the output, check the JES job log for system 
messages, check the SYSPRINT data set for MVS configuration program 
messages, ensure that you received all expected output, and check the reports in 
the SYSRPT data set against the planned I/O configuration. 


1. Check the JES job log: 


If the messages indicate a JCL error: 


— If the error is in installation-provided JCL, correct the error and 
rerun the job. 


— If the error is in IBM-provided JCL (the MVS configuration program 
cataloged procedure or one of the two SAMPLIB members), refer to 
the MVS/Extended Architecture MVS Configuration Program: 
Diagnostic Guide. 


Look for message IEF 142I: 

Message IEF142I, If present, indicates that the MVS configuration 
program ran to completion. The IEF142I condition code corresponds to 
the MVS configuration program return code. Check the MVS 
configuration program messages and return code in the SYSPRINT data 
set. For an explanation of messages and return codes, see “MVS 
Configuration Program Messages and Return Codes” on page 10-2. 


— Ifthe MVS configuration program messages indicate a successful run, 
go to step 2 on page 8-20. 


— Ifthe MVS configuration program messages identify an error that 
you should be able to correct, such as an input stream error, make 
the correction and rerun the job. If after the correction the error 
persists, refer to the MVS/Extended Architecture MVS Configuration 
Program: Diagnostic Guide. 


— If the MVS configuration program messages indicate an error that 
you are unable to correct, for example, an MVS configuration 
program logic error, refer to the MV S/Extended Architecture MVS 
Configuration Program: Diagnostic Guide. 


If the JES job log or a dump indicates system abend 088: 

The reason code that accompanies the abend code identifies the reason 
for the error. There will also be a corresponding MVS configuration 
program message that further explains the error. 


— MVS configuration program messages are documented in “MVS 
Configuration Program Messages and Return Codes” on page 10-2. 


— If you ran the MVS configuration program on MVS/370, for abend 


codes and reason codes see OS/VS Message Library: VS2 System 
Codes. 
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— If you ran the MVS configuration program on MVS/XA, for abend 
codes and reason codes see MVS/Extended Architecture Message 
Library: System Codes. 


— If the messages provide enough information for you to correct the 
error, for example, message CBP148I indicates an incorrect LRECL 
specification in one of your DD statements, make the correction and 
rerun the job. If, after the correction, the error persists, refer to the 
MVS/Extended Architecture MVS Configuration Program: Diagnostic 
Guide. 


— If the messages provide insufficient information for you to correct the 
error, refer to the MVS/Extended Architecture MVS Configuration 
Program: Diagnostic Guide. 


@ If the JES job log or a dump indicates a system abend other than 088: 
Refer to the MVS/Extended Architecture MVS Configuration Program: 
Diagnostic Guide. 


2. Check for correct output: 
Figure 8-6 identifies, for each mode (IODEF, EDT, VALIDATE, and 
DEBUG), the output that the MVS configuration program produces when it 
executes successfully and the ddname that defines the data set to which the 
output is written. An X identifies expected output. 


If output is missing, refer to the MVS/Extended Architecture MVS 
Configuration Program: Diagnostic Guide. 


[Out ——SOSCS~“*~*~*S*S*S*S*S*S*S*S ODER ~S~S~*EDT~*~*~*~SALADATE__| DEBUG 
jos repon GYSRPNSOSC—~—XC~=<‘iSSC“‘“SC~dKSCSC“‘(SNNSOCKOC~*S 
Allocation report @ummary) GYSRP)_[X sd X SCX OCS 


Allocation report (full report) 
(SYSRPT) oe note 2a on 
ae 8-21.) 
NIP report (SYSRPT) a es ee 
MVSCP messages (SYSPRINT) 
ee note 2b on ae note 2b on ae note 2c on ee note 2c on 
4 8-21.) os 8-21.) ——— 8-21.) a 8-21.) 
Return code |Returncode(SYSPRINT) ssi 
Input statement listing (summary) 
(SYSASMP) 
Input statement list (full listing) 
Cr ee 


Parsing macro | Parsing macro listing (SYSASMP) (SYSASMP) 


Assembler RLD (SYSASMP) po 


Assembler cross-reference listing 
(SYSASMP) 


Assembler ESD (SYSASMP) a Sa a | ae 
[Loader map (SYSLOUT) aaa See! | 


Linkage editor map (SYSLKEDP) 
es note 2e on note 2f on 
oe 8-21.) ee 8-21.) 
JES3 data (SYSJES3) 
ae note 2d on a note 2d on 
page 8-21.) page 8-21.) 


Figure 8-6 (Part 1 of 2). Normal MVS Configuration Program Output 
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[1OSIITax member SYSLMOD) [xsd SOOS—SOO 
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MEANCTax member SYSLMOD) [x —S—Sid—SSSOSCSCS OOS 


Figure 8-6 (Part 2 of 2). Normal MVS Configuration Program Output 





Notes: 
a. The full allocation report consists of: 


Lookup value section. 
Generic section. 

Group section. 

Group pointer section. 
Group descriptor section. 
Device number section. 
Group mask section. 
Device number summary. 


b. The MVS configuration program issues CBP149I. If JES3 output was 
requested and successfully written, the MVS configuration program also 
issues CBP600I. The MVS configuration program may also issue other 
messages depending on the conditions it detects. 


c. The MVS configuration program issues CBP144I. The MVS configuration 
program may also issue other messages depending on the conditions it 
detects. 


d. The MVS configuration program writes JES3 data only if the SYSJES3 
data set has been allocated and the name of the JES3 data set has been 
specified in the invocation JCL. 


e. The linkage editor map should indicate that members IOSUCBxx, 
IOSITxx, IEFEDTxx, and IEANCTxx have been replaced. 


f. The linkage editor map should indicate that member IEFEDTxx has been 
replaced. 


3. Review the reports: 
If you have received all expected output, review the MVS configuration 
program reports (For an explanation of how to read the reports, see 
Chapter 9, “Reading MVS Configuration Program Reports” on page 9-1). 
If information is missing or is incorrect, refer to the MV S/Extended 
Architecture MVS Configuration Program: Diagnostic Guide. 


4. Refer to the Diagnostic Guide:. 
If the MVS configuration program messages and output appear to be correct 
but configuration-related errors occur when the installation uses the 
configuration, refer to the MV S/Extended Architecture MVS Configuration 
Program: Diagnostic Guide. 
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Chapter 9. Reading MVS Configuration Program Reports 


The MVS configuration program writes three reports: 


e AnJ1/O supervisor (IOS) report. 
e An allocation report. 
e A nucleus initialization program (NIP) report. 


The MVS configuration program writes the reports when it runs in either IODEF 
mode, EDT mode, or VALIDATE mode, and it issues a return code no greater 
than 4. 


The MVS configuration programs writes the reports to the //SYSRPT data set. 
The reports contain the following information: 


Report Content 

IOS Identifies by device number, unit, and model each device included in 
the configuration. Each line in the report represents a unique device 
number within that configuration. The report also includes for each 


device: 


e@ The base device number (base exposure) if the device is a 
multiple exposure device. 


e The names of the error recovery program, device descriptor 
table, module list table (identifies device support modules), and 
unit information module (UIM) for the device. 


e The status of specific UCB fields for the device. 


Allocation Contains the following information for each generic device type and 
for each esoteric device group: 


e The group name and whether it is a generic group or an esoteric 
group. 


@ Whether the group is eligible for VIO. 


e Any generics or esoterics that the MVS configuration program 
automatically generates. 


e The affinity index assigned to the device type. 


e Data that corresponds to the UCB field UCBTYP. 
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e A list of the device numbers that the group includes. The report 
organizes the numbers to show how they are mapped into 
different allocation groups. 


NIP Identifies by device number, unit, and model the devices that NIP 
will be allowed to use as consoles. The report lists the devices in the 
order NIP will try to use them. 


Locating Information in this Chapter 


This chapter contains the following major topics: 


Requesting Reports and Validating the Input Stream 9-2 
Reading the IOS Report 9-4 

Reading the Allocation Report 9-6 

Reading the NIP Report 9-8 


Note: The acronym MVSCP is used in the reports and other 
computer-generated output to refer to the MVS configuration program. 





Requesting Reports and Validating the Input Stream 


You can request the reports and validate the input stream without building an I/O 
configuration. You may want to do this, for example, if you have lost the reports 
for an existing configuration. 


To request the reports, run the MVS configuration program in VALIDATE 


mode. The SYSIN data set must contain the input statements that define the 
configuration for which you want the report. 
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Reading the IOS Report 


MVSCP LEVEL 1.9 


146 


147 
190 
191 
220 
221 


222 
223 
3E0 
410 
411 


440 
441 
450 
GE2 
570 


640 
AG0 
A4l1 
AG42 
A43 


F20 
F21 
F22 
F23 


@ 


Q® 


MVSCP LEVEL 1.0 


KEY 


Figure 9-1. 


DEVS 
STMT 
UNIT 
UCBTYP 
BASE 
ERP-NAME 
DDT -NAME 
MLT~NAME 
OPT 
UIM-NAME 


ATI 
AL 
SH 
SW 
MX 
MI 


0 
Y 
BLANK 


CLASS NAME CLASS TYPE 
TAPE 80 
COMMUNICATION DEVICES 40 
C-T-C 41 
DASD 20 
GRAPHICS 10 
UNIT RECORD 08 
CHARACTER READERS 04 


rtn)retetttete 


IOCONFIG ID=05 


KEY DESCRIPTION 


DEVICE NUMBER 
STATEMENT WHICH DEFINED THIS DEVICE 
DEVICE NAME 


UCB TYPE BYTES 
BASE DEVICE NUMBER FOR MULTIPLE EXPOSURE DEVICES 


I0S CONTROL BLOCK REPORT 


ERROR RECOVERY PROGRAM 
DEVICE DESCRIPTOR TABLE 
MODULE LIST TABLE 
OPTIONAL MLT INDICATOR 
UNIT INFORMATION MODULE 


ATTENTION TABLE INDEX CUCBATI) 


© 


ALTERNATE CONTROL UNIT CUCBALTCU) 
SHARED UP OPTION CUCBSHRUP) 


DEVICE CAN BE SWAPPED BY DDR CUCBSWAPF) 
DEVICE HAS MULTIPLE EXPOSURES (UCBMTPXP) 


MIH PROCESSING SHOULD BE BYPASSED CUCBMIHPB) 
MLT IS OPTIONAL 


DEVICE SUPPORTS THIS FEATURE 


DEVICE DOES NOT SUPPORT THIS FEATURE 


TOTAL NUMBER OF DEVICES BY CLASS 


DEVICE COUNT 


-— ee — 


TOTAL NUMBER OF I/0 DEVICES DEFINED BY THIS I/0 CONFIGURATION 


IOS Report Example 
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IOCONFIG ID=05 IOS CONTROL BLOCK REPORT 

@ IOCP MSG1 = 'I70 CONFIGURATICN 05 

IOCP MSG2 = ! 

STMT UNIT MODL UCBTYP BASE ERP-NAME DDT-NAME MLT-NAME OPT UIM-NAME 
15 2540R 1 10000801 IGEQ001C IECVDDT5 IEAMLT34 (1) CBPUSO12 
16 3800 lOO0089E IGE0000G IGGDDTP1 IEAMLTO9 CBPUSO11 
17 3800 1000080E IGE0000G IGGDDTP1 IEAMLTO9 CBPUSO11 

3 2305 2 30502007 140 IECVDERP IGGDDTO5 IEAMLT10 CBPUSO13 
3 2305 2 30502007 140 IECVDERP IGGDDTO05 IEAMLT10 CBPUSO13 
3 2305 2 30502007 140 IECVDERP IGGDDT05 IJIEAMLT10 CBPUS013 
3 2305 2 30502007 140 IECVDERP IGGDDTO5 IEAMLT19 CBPUSO13 
3 2305 2 30502007 140 IECVDERP IGGDDTO05 IEAMLT10 CBPUSO13 
3 2305 2 30502007 140 IECVDERP IGGDDTO05 IEAMLT10 CBPUSO13 
3 2305 2 30502007 140 IECVDERP IGGDDT053 IEAMLT10 CBPUSO13 
3 2305 2 30502007 140 ITECVDERP IGGDDTO05 IEAMLT10 CBPUS013 
§ 3380 3010200E IECVDERP IGGDDTO1 IEAMLTO2 CBPUSO02 
4 3380 3010200E @) IECVDERP IGGDDTO1 IEAMLTO2 CBPUSO02 
5 3380 3010200E IECVDERP IGGDDTO1 IEAMLTO2 CBPUSO02 
5 3380 SO10200E IECVDERP IGGDDTO1 MIEAMLTO2 CBPUSO002 
5 3380 SO010200E IECVDERP IGGDDTO01 IEAMLTO2 CBPUSO02 
5 3380 3010200E IECVDERP IGGDDTO1 IEAMLTO2 CBPUSO02 
13 3277 2 12001009 IGEOQ010E IECVDDT4 IEANLTOS CBPUSO04 
6 3350 30502008 IECVDERP IGGDDT04 IEAMLTO3 CBPUS001 
6 3350 30502008 IECVDERP IGGDDTO04 IEAMLTO3 CBPUSO01 
7 3330 1 30502009 IECVDERP IGGDDT30 IEAMLT11 CBPUS001 
7 3330 1 30502009 IECVDERP IGGDDT30 IEAMLT11 CBPUSO001 
11 3480 78008080 IGEQO001E DDTR3480 IEAMLTO8 CBPUSO05 
14 3270 xX 12001009 IGEQQ10E IECVDDT4 IEAMLTOS5 CBPUS004 
12 3420 3 34008003 IGEQO00I DDTR3400 IEAMLTO6 CBPUSOOS5 
8 3330 (s) 30502009 IECVDERP IGGDDT30 IEAMLT11 CBPUSOO01 
9 3380 3010200E IECVDERP IGGDDTO1 IEAMLTO2 CBPUSO02 
9 33380 3010200E IECVDERP IGGDDTO1 IEAMLTO2 CBPUSO02 
9 3380 3010200E IECVDERP IGGDDTO01 IEAMLTO2 CBPUSO02 
9 3380 3010200E IECVDERP IGGDDTO1 IEAMLTO2 CBPUSO02 
10 3380 3010200E IECVDERP IGGDDTO1 IEAMLTO2 CBPUS002 
10 3380 3010200E IECVDERP IGGDDTO1 IEAMLTO2 CBPUSO02 
10 3380 3010200E IECVDERP IGGDDTO1 IEAMLTO2 CBPUS?02 
10 3380 3010200E IECVDERP IGGDDTO1 IEAMLTO2 CBPUSO02 


® 


34 


TIME: 14.12 DATE: 04707786 
' 
' 
ATI AL SH SW MX MI 
0 Y 
0 
0 
0 Y 
0 Y 
0 Y 
0 Y 
0 Y 
0 Y 
0 Y 
0 Y 
0 
0 
0 
0 
0 
0 
28 
0 
0 
0 Y 
0 ¥ 
0 y 
28 
0 ¥ 
0 Y 
0 
0 
0 
0 
0 
0 
0 
0 
TIME: 14.12 DATE: 04707786 


PAGE 


PAGE 
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10. 


11. 


13. 


Information from the MSG1 and MSG? fields of the IOCP ID statement. 
The device number assigned to the device. 


The sequence number of the IODEVICE statement that defined the I/O 
device. The MVS configuration program numbers the statements sequentially 
starting with the first statement in the input stream. The Assembler prints 
each input statement along with its corresponding MVS configuration 
program sequence number. 


The device type. This information comes from the IODEVICE statement 
UNIT parameter. 


The model of the device. This information comes from the IODEVICE 
statement MODEL parameter. 


The UCB type field. This information comes from the UCBTYP field of the 
device’s UCB. 


The base exposure of a multiple exposure device. 


The name of the error recovery program that handles device errors for the 
defined device. 


The name of the device descriptor table. This table identifies the modules 
that perform device dependent processing for the defined device. 


The name of the module list table. This table identifies the device support 
modules for the defined device. 


The module list table indicator. This field identifies optional module list 
tables. O indicates an optional table. 


. The name of the unit information module (UIM) that processed the 


IODEVICE statement for the specified device. 


UCB information for the specified device. The UCB is described in 
MVS/Extended Architecture Debugging Handbook Volume 5. 


ATI - (UCBATI): The attention table index. 


AL - (UCBALTCU): Y indicates that the device has an alternate control 
unit, a blank indicates that it does not. 


SH - (UCBSHRUP): Y indicates that the device is sharable in 
uniprocessor mode, a blank indicates that it is not. 


SW - (UCBSWAPF): Y indicates that the device can be swapped, a 
blank indicates that it cannot. 


MX - (UCBMTPXP): Y indicates that the device is a multiple exposure 
device, a blank indicates that it is not. 


MI - (UCBMIHPB): Y indicates that missing interrupt handler checking 
is to be bypassed, a blank indicates that it is not to be bypassed. 


. A key that briefly describes each area of data found in the report. 


. A summary of the devices defined in the configuration by device class. The 


device classes correspond to the classes defined in the UCB field UCBTBYT3. 


. The number of devices defined in each device class. Each device number is 


counted as a device. 


Chapter 9. Reading MVS Configuration Program Reports 9-5 





Reading the Allocation Report 


MVSCP LEVEL 1.0 IEFEDTOS FORMAT - DEVICE NUMBER SUMMARY TIME: 14.12 DATE: 04/07/86 PAGE 1 
AFFINITY ALLOCATION ASSOCIATED 
UNIT NAME NAME TYPE VIO INDEX DEVICE TYPE GENERICS DEVICE NUMBER LIST 
2305-2 GENERIC G) FFFF 30502007 140 
3380 GENERIC FFFF 3010200E 190 191 220 221 222 223 AGO A41 A42 AGS F20 F21 
F22 F23 
3330-1 GENERIC 0002 3050200D 410 411 
3330 GENERIC 0001 30502009 440 441 640 
3480 GENERIC 0008 78008080 450 
3400-3 GENERIC 0030 34008003 570 
3800 GENERIC FFFF 1000080E QOE O11 
2540 GENERIC FFFF 10000801 ooc 
3277-2 GENERIC FFFF 12001009 3E0 4E2 
2400-3 G/GENERIC 0030 34008003 3400-3 570 
3400-9 G/GENERIC 0008 78008080 3480 450 
SYSALLDA G/ESOTERIC FFFF 30502007 2305-2 140 
3010200E 3380 190 191 220 221 222 223 A4&0 AG1 A4G2 A43 F20 F2l 
© @ ® F22 F23 
3950200D 3330-1 410 411 
39502009 3330 440 441 640 


©) © @ 


Figure 9-2. Allocation Report Example 
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The name of the device group as it appeared on a UNITNAME statement 
NAME parameter. 


Indicates whether this is a generic device group or an esoteric device group. 
G/GENERIC identifies a generic group that includes generated generics. 
G/ESOTERIC identifies a group that contains generated esoterics. The 
column labeled “ASSOCIATED GENERICS” identifies the included generics. 
The MVS configuration program includes generated generics so installations 
can still use older JCL input streams on the newer releases of MVS. 


Indicates whether the group is eligible for VIO. Y indicates an eligible group. 
A blank indicates an ineligible group. 


The affinity index for the device type. Used by MVS allocation programs to 
determine which devices have affinity to each other. Devices have affinity if 
either of the following statements are true: 


e@ The devices have the same affinity index 


e The affinity index for one of the devices is a subset of the other device's 
affinity index 


An affinity index is a subset of another if both of the following statements are 
true: 


@e Neither index has a value of X’FFFF’ 


@ One or more bits in one index are set to binary one and one or more 
corresponding bits in the other index are also set to binary one. 


The format and the meaning of the information in this field is the same as 
UCBTYP field in the UCB. For a description of the UCBTYP field, see 
MVS/Extended Architecture Debugging Handbook Volume 5. 


Identifies the generics that the group includes. If the column labeled “NAME 
TYPE” specifies G/GENERIC, this column, “ASSOCIATED GENERICS,” 
identifies the generated generics. 


The device numbers of the devices that are included in the group. Where a 
generic or esoteric group consists of more than one allocation group 
indentation of the device numbers in the report identifies the different 
allocation groups. 
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Reading the NIP Report 


MVSCP LEVEL 1.0 IOCONFIG ID=05 NIP CONTROL BLOCK REPORT TIME: 14.12 DATE: 04707786 


NIP CONSOLE DEVICES 





Figure 9-3. NIP Report Example 
1. The device numbers of the NIP console. 


2. The device type. This information corresponds to the UNIT parameter on 
the IODEVICE statement. 


3. The model. This information corresponds to the MODEL parameter on the 
IODEVICE statement. 
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Chapter 10. Debugging, Messages, and Codes 


Debugging Input 


This book divides the problems you may encounter while using the MVS 
configuration program into two categories: input stream problems and MVS 
configuration program problems. Depending on the type of problem, you can 
receive one or more messages, an ABEND code and a reason code, or both. This 
chapter provides suggestions for debugging problems and contains the MVS 
configuration program messages and return codes. 


Note: MVS configuration program abend codes and reason codes are 
documented in the following books: 


e Ifyou run the MVS configuration program on MVS/XA, see MVS/Extended 
Architecture Message Library: System Codes. 


e If you run the MVS configuration program on MVS/370, see OS/VS Message 
Library: VS2 System Codes. 


Stream Problems 


Input stream problems are usually caused by coding errors on the input 
statements, information omitted from the statements, omitted statements, or 
errors in the parameters you provide. You will receive messages that indicate the 
cause of the problem. You can receive messages from the assembler, the linkage 
editor, the loader, or the MVS configuration program. These messages appear in 
the data sets that are defined by the following DD statements: 


The SYSASMP data set also contains a listing of the input statements. A number 
that the MVS configuration program prints next to each statement and next to 
each message enables you to correlate messages to the affected input statement. 
To correct input stream problems, follow the instructions found in the message 
documentation. 










If the SYSPRINT data set cannot be opened, a message will appear in the job 
listing. 
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Debugging the MVS Configuration Program 


MVS configuration program problems can be caused by logic errors in either the ~ 
MVS configuration program, (including the IBM-provided UIMs), logic errors in 

programs invoked by the MVS configuration program (assembler, linkage editor, 

and loader), or by logic errors in installation-provided UIMs. MVS configuration 

program problems are indicated by messages and, possibly, by an ABEND code 

and reason code. 


If the MVS configuration program job ABENDS and the invocation JCL 
contains either a SYSABEND, SYSMDUMP, or SYSUDUMP DD statement, 
you will also receive a dump. 


Depending on the type of problem the MVS configuration program encounters, 
DEBUG mode might provide additional information that can help you solve the 
problem. If you suspect any of the following problems, select DEBUG mode: 


e The MVS configuration program parsing macros are generating incorrect 
code 

@ The loader is having a problem loading MVS configuration program records 

@ There are problems with EDT information 

e The MVS configuration program ESTAE is masking a problem 


To analyze MVS configuration program problems, use the message 
documentation and any dump information that you receive. 


MVS Configuration Program Messages and Return Codes 


Message Format 


Each time the MVS configuration program executes, it issues messages and a 
return code. Those messages and return codes are explained in this chapter. 


In addition to the messages documented in this chapter, you may also receive 
messages from the Assembler, the Loader, or the Linkage Editor. 


Note: Messages in the range CBP900 to CBP999 are reserved for installations to 
use when they write UIMs. 


Each MVS configuration program message has the following format: 


STATEMENT SEV MSG ID MESSAGE TEXT 


STATEMENT 
The assigned number of the input statement, if any, that caused the MVS 
configuration program to issue the message. The input statements and their 
numbers appear in the SYSASMP data set following the messages. 


There may be multiple messages that pertain to one input statement. ) 
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SEV 


The severity of the message 


Severity 


I 


MESSAGE ID 


Meaning 


Informational message. An informational message has no affect 
on MVS configuration program processing. 


Warning message. A warning message has no affect on MVS 
configuration program processing. You should, however, read 
all of the warning messages issued to ensure that an acceptable 
I/O configuration was built. 


Error message. The MVS configuration program performs a 
syntax check and semantic check of the entire input stream but 
does not build an I/O configuration. 


Terminating message. The MVS configuration program 
abnormally terminates without processing the remaining input 
Statements. 


A seven character alphanumeric value that uniquely identifies each message. 
The messages in this chapter are arranged in ascending order according to 
message identifiers. 


MESSAGE TEXT 
Information that summarizes the condition that caused the MVS 
configuration program to issue the message. 


How This Book Presents Message Information 


This book presents the messages in ascending numerical order. First it presents 
the message number and the message text. This is followed by: 


Explanation 


An explanation of the condition that caused the message to be issued. 


System Action 


A description of the way that the MVS configuration program handles the 


condition. 


System Programmer Response 
An explanation of what you should do to correct the condition or to further 
isolate the problem. 


Note: In MVS configuration program messages, the acronym WTO refers 
to the write-to-operator macro. 
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What the Return Codes Mean 


The MVS configuration program issues return codes 0, 4, 8, and 16. The return ) 
code issued corresponds to the highest severity ievel message issued. 


fo [Informational message OOS 
fe‘ Error message SSCS 







Example of Message Output 


The following figures show an example of a partial assembler listing of an MVS 
configuration program input stream and the messages that resulted from 
processing that stream. If a message refers to a specific input statement, the 
statement number that the MVS configuration program assigned appears to the 
left of the message. For example, in Figure 10-1, message CBP401I refers to 
statement 9. In Figure 10-2 on page 10-5, statement 9 corresponds to assembler 
statement number 2062. 


MVS Configuration Program Messages 


MVSCP LEVEL 1.0 IOCONFIG ID=05 TIME: 16.20 DATE: 02721786 PAGE 1 
STATEMENT SEV MSG ID MESSAGE TEXT 


9 E CBP401I 12 IS NOT A VALID MODEL NUMBER FOR THE 3330 DEVICE 
11 E CBP352I FEATURE AUTOPOLL NOT RECOGNIZED FOR 3380 DEVICE 


W CBP4¢00I THE 3851 AND 3330V DEVICES SHOULD BOTH BE SPECIFIED OR 
OMITTED FROM THE I70 CONFIGURATION DEFINITION 


I CBP145I NO OUTPUT WRITTEN TO SYSLMOD DATA SET. VALIDATE 
PROCESSING FORCED DUE TO ERROR 
3 I CBP429I REPLICATION FACTOR OF ONE IS USED. EIGHT DEVICE NUMBERS 
DEFINED 
TOTAL MESSAGES INFORMATIONAL WARNING ERROR Lene eee 
5 2 1 2 


RETURN CODE WAS 8 


Figure 10-1. MVS Configuration Program Message Example 
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Assembler Listing of Input Statements 


MVSCP INPUT LISTING 


LOC OBJECT CODE ADDR1 ADDR2 STMT SOURCE STATEMENT ASM H V 02 16.20 


17 BD 336 HIE IESE IE IE HE IEE IE IE EE EE EE 3E 5G EE EE EEE 2G EE 36 3G E 3G IE 36K 3C 6 EE EE EE IE EE 3C ESE UE JE DE DE DE IE DE 3 3C 0 50 56 30 58 3E5E OE OF 
1783 * DASDS % 
We MTT TTT ee eT Te Te eT eT TET EET EEE ELE Le tt titstettotetetstatetstetetatatetatatetatete: 
1785 * 
1786 IODEVICE ADDRESS=(140,8),UNIT=2305,MCDEL=2, CUNUMBR=021 
1787+*%, 3 IS THE PREVIOUS MVSCP STATEMENT NUMBER 
1788+ 
1830+ 
1831+ 
1832 IODEVICE ADDRESS=(190,2),UNIT=3380,CUNUMBR=023 
1833+, THE PREVIOUS MVSCP STATEMENT NUMBER 
1834+ 
1876+ 
1877+ 
1878 IODEVICE ADDRESS=(1A0,6),UNIT=3330V,CUNUMBR=024 
1879+, THE PREVIOUS MVSCP STATEMENT NUMBER 
1880+ 
1922+ 
1923+ 
1924 IODEVICE ADDRESS=(220,4),UNIT=3380,CUNUMBR=027 
1925+, THE PREVIOUS MVSCP STATEMENT NUMBER 
1926+ 
1968+ 
1969+ 
1970 IODEVICE ADDRESS=(€410,2),UNIT=3330,MODEL=1,CUNUMBR=031 
1971+, THE PREVIOUS MVSCP STATEMENT NUMBER 
1972+ 
2014+ 
2015+ 
2016 IODEVICE ADDRESS=(440,2),UNIT=3350,CUNUMBR=0 34 
2017+, THE PREVIOUS MVSCP STATEMENT NUMBER 
2018+ 
2060+ 
2061+ 
2062 IODEVICE ADDRESS=(610,2),UNIT=3330,MODEL=12,CUNUMBR=019 
2063+, THE PREVIOUS MVSCP STATEMENT NUMBER 
2064+ 
2106+ 
2107+ 
2108 IODEVICE ADDRESS=(640,2),UNIT=3350,CUNUMBR=002 
ae te 10 IS THE PREVIQUS MVSCP STATEMENT NUMBER 
+ 
2152+ 
2153+ 
2154 IODEVICE ADDRESS=(820,2),UNIT=3380,FEATURE=AUTOPOLL, 
CUNUMBR=041 
Sree 11 IS THE PREVIOUS MVSCP STATEMENT NUMBER 
+ 
2200+ 
2201+ : 
2202 IODEVICE ADDRESS=(CA40,4),UNIT=3380,CUNUMBR=047 
ia 12 IS THE PREVIOUS MVSCP STATEMENT NUMBER 
+ 
2246+ 
2247+ 


Figure 10-2. Assembler Listing Example 
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00000300 
00000400 
00000500 


00000600 
02-01441 
02-01442 
01-01254 
01-01255 
00001110 
02-01441 
02-01442 
01-01254 
01-01255 
00000700 
02-01441 
02-01442 
01-01254 
01-01255 
00001110 
02-01441 
02-01442 
01-01254 
01-01255 
00000800 
02-01441 
02-01442 
01-01254 
01-01255 
00000900 
02-01441 
02-01442 
01-01254 
01-01255 
00001000 
02-01441 
02-01442 
01-01254 
01-01255 
00001100 
02-01441 
02-01442 
01-01254 
01-01255 


X00001110 


02-01441 
02-01442 
01-01254 
01-01255 
00001110 
02-01441 
02-01442 
01-01254 
01-01255 
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CBP100I 


CBPI101I 


CBP102I 


CBP1031 


VALIDATE PROCESSING ASSUMED. INVALID INPUT PARAMETER STRING: 
{stringINONE SPECIFIED} 





Explanation: The input parameter string specified on the EXEC statement of the JCL was - 
invalid, or no input string was specified. 


System Action: The MVS configuration program performs a syntax check and a semantics check 
on the input stream statements. The MVS configuration program does not write the I/O 
configuration to the output data set, however. 

System Programmer Response: Correct the input parameter string on the EXEC statement and 
rerun the job. 


ESTAE ENTERED: SYSTEM CODE system-code [REASON CODE reason-code| 


Explanation: An unexpected error occurred, causing the ESTAE to get control. The reason code 
appears only when the system code is X’088’. 


System Action: MVS configuration program execution terminates. 

System Programmer Response: Refer to the diagnostic procedures explained in the book 
MVS/Extended Architecture MVS Configuration Program: Diagnostic Guide. 
CONFIGURATION ID NOT SPECIFIED 


Explanation: The MVS configuration program input stream does not contain an IOCONFIG > 
statement that specifies the configuration identifier. : 


System Action: The MVS configuration program performs a syntax check and a semantics check 
on the input stream statements. The MVS configuration program does not write the I/O 
configuration to the output data set, however. 


System Programmer Response: Add a correctly coded IOCONFIG statement to the input stream 
and rerun the job. 
MORE THAN ONE CONFIGURATION ID SPECIFIED 


Explanation: The MVS configuration program input stream contains more than one IOCONFIG 
Statement. 


System Action: The MVS configuration program performs a syntax check and a semantics check 
on the input stream statements. The MVS configuration program does not write the I/O 
configuration output, however. 


System Programmer Response: Remove the duplicate statement from the input stream and rerun 
the job. 
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CBP1041 


CBP105I 


CBP106! 


CBP110I 


DIAGNOSTIC ENTRY NOT ON STACK 


Explanation: A module invoked by the MVS configuration program made an invalid attempt to 
remove a diagnostic entry from the stack. 


System Action: MVS configuration program execution terminates with system ABEND ‘088’X, 
reason code ‘104’X. The correctness of the data in the variable recording area (VRA) of the 
system diagnostic work area (SDWA) cannot be guaranteed. 

System Programmer Response: Refer to the diagnostic procedures explained in the book 
MVS/Extended Architecture MVS Configuration Program: Diagnostic Guide. 

INPUT DDNAME LIST IS NOT VALID, {DDNAME LIST TOO LONG | NULL DDNAME 
OVERRIDDEN} 


Explanation: The MVS configuration program was invoked with a DDNAME list that was 
invalid. Either too many DDNAMES were provided, or a null DDNAME was overridden. 


System Action: MVS configuration program execution terminates with system ABEND ‘088’X 
and reason code °105’X. 


System Programmer Response: Correct the DDNAME list and rerun the job. For a description 
of the DDNAME list, see “Standard DD Name List” on page 8-18. 
DUPLICATE ATTEMPT TO ADD DIAGNOSTIC STACK ENTRY 


Explanation: A module invoked by the MVS configuration program attempted to add an entry 
to the diagnostic stack while the entry was already on the stack. 


System Action: MVS configuration program execution terminates with system ABEND ‘088’X 
and reason code ‘106’X. 


System Programmer Response: Refer to the diagnostic procedures explained in the book 
MVS/Extended Architecture MVS Configuration Program: Diagnostic Guide. 
OPEN FAILED FOR DDNAME ddname 


Explanation: An MVS configuration program routine invoked CBPMRWR, which could not 
open the file. 


System Action: MVS configuration program execution terminates. 


System Programmer Response: Refer to the diagnostic procedures explained in the book 
MVS/Extended Architecture MVS Configuration Program: Diagnostic Guide. 
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CBP111I 


CBP112I] 


CBP115] 


CBP120I 


FILE CODE file-code AND/OR FUNCTION CODE function-code INVALID 


Explanation: The file code, the function code, or both are invalid; or the file code is “ALL” but 
the function code is not “CLOSE.” 


System Action: MVS configuration program execution terminates with a system ABEND code of 
‘088’X and a reason code of ‘111’X. 


System Programmer Response: Refer to the diagnostic procedures explained in the book 
MVS/Extended Architecture MVS Configuration Program: Diagnostic Guide. 
MESSAGE ISSUED WHILE THE MESSAGE LOG FILE WAS CLOSED 


Explanation: An MVS configuration program routine attempted to issue a message while the 
message log file was closed. 


System Action: MVS configuration program execution terminates with a system ABEND code of 
‘088’and a reason code of ‘112’X. 


System Programmer Response: Refer to the diagnostic procedures explained in the book 
MVS/Extended Architecture MVS Configuration Program: Diagnostic Guide. 

RECORD LENGTH FOR ddname FILE MUST BE record-length 

Explanation: An attempt has been made to open the ddname file with an incorrect record length. 
ddname is the DDNAME of the file. record-length is the valid value or range for the record 
length. 


System Action: MVS configuration program execution terminates. 


System Programmer Response: Correct the JCL and rerun the job. 


ASSEMBLER {RETURN|COMPLETION} CODE WAS code 


Explanation: The assembler encountered an error while parsing the input statements. code is the 
RETURN code or COMPLETION code. 


System Action: MVS configuration program execution terminates. 
System Programmer Response: This problem is probably caused by either: 
e An input stream error. 

e Insufficient space on an assembler work file. 

e AnEND statement was included in the input stream. 


Assembler messages, if there are any, are on the SYSASMP data set. 


After fixing the problem, rerun the job. 
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CBP1211 


CBP1401 


CBP141I 


CBP142I 


NO RECORDS IN MVSCP INPUT FILE 

Explanation: The MVS configuration program input data set is empty. 

System Action: MVS configuration program execution terminates. 

System Programmer Response: Verify that you specified the correct data set name. After 
correcting the problem, rerun the job. 

ACON LENGTH IS NOT THREE OR FOUR 


Explanation: Logic error within the MVS configuration program. Only three or four byte 
ACONs can be resolved. 


System Action: MVS configuration program execution terminates with a system ABEND code of 
‘088’X and a reason code of ‘140’X. 


System Programmer Response: Refer to the diagnostic procedures explained in the book 
MVS/Extended Architecture MVS Configuration Program: Diagnostic Guide. 

ACON POSITION POINTER IS NOT WITHIN ITS OWN TABLE/CSECT 
Explanation: Each ACON must be defined within its own table. 


System Action: MVS configuration program execution terminates with a system ABEND code of 
‘088’X and a reason code of ‘141’X. 


System Programmer Response: Refer to the diagnostic procedures explained in the book 
MVS/Extended Architecture MVS Configuration Program: Diagnostic Guide. 
ACON RELOCATION POINTER TARGET IS NOT WITHIN ITS OWN MODULE 


Explanation: The value at the ACON must be an address that is defined by one of the tables of 
the module. 


System Action: MVS configuration program execution terminates with a system ABEND code of 
‘088’X and a reason code of ‘142’X. 


System Programmer Response: Refer to the diagnostic procedures explained in the book 
MVS/Extended Architecture MVS Configuration Program: Diagnostic Guide. 


Chapter 10. Debugging, Messages, and Codes 10-9 


CBP143] 


CBP144I 


CBP145I 


CBP146l 


I/O CONFIGURATION MEMBERS ON ddname DATA SET ARE INVALID. LINK EDIT 
{RETURN CODE | COMP CODE} WAS code 


Explanation: The linkage editor was unable to successfully write the I/O configuration members 
to the ddname data set. (ddname is SYSLMOD, unless overridden in the MVS configuration 
program input DDNAME list). The linkage editor return code or completion code indicates the 
reason for failure. Only I/O configuration members that were being written during this 
invocation of the MVS configuration program are in error. 

System Action: None. 

System Programmer Response: Refer to the diagnostic procedures explained in the book 
MVS/Extended Architecture MVS Configuration Program: Diagnostic Guide. 

OUTPUT TO ddname NOT REQUESTED. MODE IS {DEBUG | VALIDATE} 

Explanation: The I/O configuration members were not written to the ddname data set. (ddname is 
SYSLMOD, unless overridden in the MVS configuration program input DDNAME list). The 
members were not written because DEBUG or VALIDATE mode was selected. 

System Action: Normal completion. 

System Programmer Response: If you wish to have the I/O configuration members written, select 
the appropriate mode (IODEF or EDT) and resubmit the jeb. 

NO OUTPUT WRITTEN TO ddname DATA SET. VALIDATE PROCESSING FORCED 
DUE TO ERROR. 

Explanation: An error prevented the MVS configuration program from writing the I/O 
configuration members to the ddname data set. ddname is SYSLMOD, unless overridden in the 
MVS configuration program input DDNAME list. 


System Action: No I/O configuration members were written. 


System Programmer Response: Correct the errors indicated by other messages and rerun the job. 


SECOND REQUEST TO QUEUE THE SAME CSECT WITHIN THE SAME MODULE 


Explanation: A second CALL was made to RTLB to queue an RTL that was previously queued 
(same module and CSECT names), or the caller modified restricted RTL field RTLQUED. 


System Action: MVS configuration program execution terminates with a system ABEND of 
‘O8&’X and a reason code of ‘146’X. 


System Programmer Response: Refer to the diagnostic procedures explained in the book 
MVS/Extended Architecture MVS Configuration Program: Diagnostic Guide. 
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CBP147] 


CBP148I 


CBP1491 


CBP2001 


ATTACH PROCESSING FAILED. RETURN CODE WAS return-code 


Explanation: The MVS configuration program attempted to ATTACH the linkage editor. The 
ATTACH failed. 


System Action: MVS configuration program execution terminates with a system ABEND of 
‘088’X and a reason code of ‘147’X. 


System Programmer Response: Refer to the diagnostic procedures explained in the book 
MVS/Extended Architecture MVS Configuration Program: Diagnostic Guide. 
LRECL MUST BE 80 FOR DDNAME ddname 


Explanation: The LRECL parameter on the ddname DD statement specifies a value other than 
80. 


System Action: MVS configuration program execution terminates. 


System Programmer Response: Change LRECL to 80 and rerun the job. 


1/0 CONFIGURATION MEMBERS SUCCESSFULLY WRITTEN TO ddname DATA SET 
Explanation: The linkage editor has written the I/O configuration members to the ddname data 
set. (ddname is SYSLMOD, unless overridden in the MVS configuration program input 
DDNAME list). The linkage editor return code was zero. 

System Action: None 


System Programmer Response: None. 


UNIT = IGNORED FOR name WHICH IS A GENERIC. 
Explanation: The UNIT = parameter was specified on a UNITNAME statement whose 
NAME= parameter specified a generic name. When the NAME= parameter specifies a generic 


name, the UNIT= parameter must be omitted. 


System Action: Processing continues normally. The MVS configuration program ignores the 
UNIT = parameter, however. 


System Programmer Response: Remove the UNIT= parameter from the UNITNAME statement 
or change the NAME= parameter to specify a non-generic name. 
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CBP201I 


CBP202I 


CBP2031 


CBP204I 


VIO=YES MUST BE SPECIFIED WITH GENERIC generic-name. 


Explanation: A generic name was specified on the NAME= parameter of the UNITNAME 
statement without specifying VIO= YES. 


System Action: The MVS configuration program performs a syntax check and a semantics check 
on the input stream statements. The MVS configuration program does not write the I/O 
configuration to the output data set, however. 


System Programmer Response: Add VIO=YES to the statement, of if message CBP200I was also 
issued, see the System Programmer Response for that message. After correcting the problem 
rerun the job. 


UNITNAME STATEMENT IGNORED. name IS A RESERVED NAME. 


Explanation: The NAME= parameter of a UNITNAME statement specified an IBM-reserved 
name. Currently, the only reserved name is SYSALLDA. 


System Action: Processing continues normally. The MVS configuration program ignores the 
UNITNAME statement, however. 


System Programmer Response: Select another name or remove the statement from the input 
stream. 


UNITNAME STATEMENT FOR name IGNORED. DUPLICATE ADDRESS device number. 


Explanation: A device number was specified more than once on the UNIT= parameter of one or 
more statements for the given name. Either the device number was coded more than once or the 
replication factor (shown as n on the UNIT= parameter of the UNITNAME statement) caused 
the device number to be specified more than once. 


System Action: The MVS configuration program performs a syntax check and a semantics check 
on the input stream statements. The MVS configuration program does not write the I/O 


configuration to the output data set, however. 


System Programmer Response: Remove the duplicate device number and rerun the job. 


VIO=YES WAS SPECIFIED FOR name WHICH IS NOT A DIRECT ACCESS DEVICE. 


Explanation: The generic name of a device that is not a direct access device was specified with 
VIO= YES. 


System Action: The MVS configuration program performs a syntax check and a semantics check 
on the input stream statements. The MVS configuration program does not write the I/O 
configuration to the output data set, however. 


System Programmer Response: Correct the UNITNAME statement that is in error and rerun the 
job. Possible errors are: 


e The NAME parameter value is misspelled 
e A generic name of a non-DASD device was specified 


10-12 MVS/XA MVS Configuration Program Guide and Reference 


J 


C 


L 


CBP2051 


CBP206I 


CBP2071 


CBP2081 


UNITNAME STATEMENT IGNORED. name WAS PREVIOUSLY DEFINED. 


Explanation: The indicated name has been previously defined on a UNITNAME statement that 
is not contiguous to this UNITNAME statement. 


System Action: Processing continues normally. The MVS configuration program ignores this 
UNITNAME statement, however. 


System Programmer Response: Either change the NAME= parameter on this UNITNAME 
statement, or move this UNITNAME statement so it is contiguous with other UNITNAME 
statements that specify the same NAME= parameter value. 


NO UNIT PARAMETER SPECIFIED FOR name. 


Explanation: On a UNITNAME statement, the NAME= parameter specified a non-generic 
name, but the UNIT= parameter was omitted from the statement. When a non-generic name is 
specified, the UNIT= parameter is required. 


System Action: The MVS configuration program performs a syntax check and a semantics check 
on the input stream statements. The MVS configuration program does not write the I/O 
configuration to the output data set, however. 


System Programmer Response: Change the NAME= parameter to specify a valid generic name 
or code the UNIT= parameter. Rerun the job. 


VIO SPECIFICATION FOR name INCONSISTENT, VIO ={YES | NO}. 


Explanation: The same name (NAME=) was specified on multiple UNITNAME statements, but 
the VIO= parameter was not the same on all statements. All of the UNITNAME statements 
that specify name are printed. 


System Action: Processing continues. The MVS configuration program assumes that you wanted 
to code VIO= YES on all of the statements. The named group of devices is considered VIO 
eligible if one of the generics corresponding to the name is a direct access device. 


System Programmer Response: Change the indicated UNITNAME statements so the VIO= 
parameter is consistent on all of the statements. 


FIRST EDT STATEMENT MUST PRECEDE UNITNAME STATEMENTS. 


Explanation: In the input stream, a UNITNAME statement appears before the first EDT 
statement. 


System Action: The MVS configuration program performs a syntax check and a semantics check 
on the input stream statements. The MVS configuration program does not write the I/O 
configuration to the output data set, however. 


System Programmer Response: If the input stream contains only one EDT statement, place it 
ahead of all UNITNAME statements. If the input stream contains multiple EDT statements, 
place each EDT statement immediately ahead of its corresponding UNITNAME statements. 

Rerun the job. 
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CBP2091 


CBP210I 


CBP211I1 


UNIT device-number SPECIFIED FOR name IS NOT A VALID DEVICE. 


Explanation: The UNIT= parameter of a UNITNAME statement specifies an unrecognized 
device number. Either the device number is not defined on an IODEVICE statement or the 
device number is a non-base exposure of a multiple exposure device. If the device number is a 
non-base exposure, you will also receive message CBP219I. 


System Action: The MVS configuration program performs a syntax check and a semantics check 
on the input stream statements. The MVS configuration program does not write the I/O 
configuration to the output data set, however. 


System Programmer Response: If the device was not defined, define the device on an IODEVICE 
statement. If the device number is a non-base exposure of a multiple exposure device, change it 
to a base exposure. Rerun the job. 


id SPECIFIED OR DEFAULTED AS THE ID FOR MORE THAN ONE EDT. 
Explanation: Multiple EDT’s were input with two specifying the same identifier. 


System Action: The MVS configuration program performs a syntax check and a semantics check 
on the input stream statements. The MVS configuration program does not write the I/O 
configuration to the output data set, however. 


System Programmer Response: Check the ID= parameter on the EDT statements. If there are 
duplicate identifiers specified, change one of them and rerun the job. 


You may omit the ID= parameter from only one EDT statement. If you have omitted the ID= 
parameter from more than one statement, correct the problem and rerun the job. 


If you have omitted the ID= parameter from only one EDT statement, look for another EDT 
statement that specifies an identifier that is the same as the I/O configuration identifier. Change 
the identifier on this EDT statement and rerun the job. 


EDT id: NO VALID DEVICES SPECIFIED FOR name. 


Explanation: For EDT id, all of the device numbers specified on the UNIT= parameter of a 
UNITNAME statement were undefined (they were not defined on an IODEVICE statement). 
The UNITNAME statement in question is the one whose NAME= parameter specifies the name 
indicated in the message text. In addition to this message, you will also receive message 
CBP2091 for each undefined device. 


System Action: The MVS configuration program performs a syntax check and a semantics check 
on the input stream statements. The MVS configuration program does not write the I/O 
configuration to the output data set, however. 


System Programmer Response: Locate all affected UNITNAME statements (there may be more 
than one). Either code an IODEVICE statement for each undefined device, or remove the 
undefined device numbers from the UNITNAME statements. After correcting the problem, 
rerun the job. 
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CBP212I1 


CBP213I 


CBP2141 


CBP215I 


EDT id: IF VIO= YES, AT LEAST ONE DEVICE SPECIFIED FOR name MUST BE A 
DIRECT ACCESS DEVICE. 


Explanation: For EDT id, a UNITNAME statement that specified an esoteric name also 
specified VIO= YES. The UNIT= parameter, however, did not specify any direct access 
devices. 


System Action: The MVS configuration program performs a syntax check and a semantics check 
on the input stream statements. The MVS configuration program does not write the I/O 
configuration to the output data set, however. 


System Programmer Response: For the specified EDT, locate all of the UNITNAME statements 
that specify the indicated name. Change the UNITNAME statements so the UNIT= parameter 
specifies at least one direct access device or remove the VIO= YES specification. After correcting 
the problem, rerun the job. 


name IN DEVPREF PARAMETER OMITTED FROM PREFTAB NOT A VALID GENERIC 
NAME. 


Explanation: The name specified in the DEVPREF parameter of the EDT statement is not a 
defined generic name. 


System Action: Processing continues normally. The MVS configuration program, however, 
omits the name from the device preference table. 


System Programmer Response: Check the DEVPREF= parameter. Either the unit information 
module (UIM) that recognizes the name is missing, or the name Is misspelled. Correct the 
problem and rerun the job. 


name IS OMITTED FROM PREFTAB. NO DEVICE DEFINED IN I/O CONFIGURATION. 


Explanation: There was no device defined in the I/O configuration for the name specified on the 
DEVPREF Keyword. 


System Action: Processing continues normally. The MVS configuration program, however, 
omits the name from the device preference table. 


System Programmer Response: Either the IODEVICE statement for the device is missing, or the 
name is misspelled. Correct the problem and rerun the job. 

EDT xx: VIO=YES ASSUMED FOR name. 

Explanation: For EDT id, the input stream contains several UNITNAME statements that 
specify the same NAME= parameter. At least one of these statements, but not all of them, also 


specify VIO= YES. 


System Action: Processing continues normally. The MVS configuration program processes the 
statements as if they all specified VIO= YES. 


System Programmer Response: To avoid receiving this message in the future, change the 
statements so the VIO= parameter is consistent. 


Chapter 10. Debugging, Messages, and Codes 10-15 


CBP216I 


CBP217I1 


CBP2181 


CBP2191 


UNIT NAME (generic-name) NOT A VALID GENERIC NAME. NO DEVICE DEVICE 
DEFINED IN THE I/O CONFIGURATION. ; 


Explanation: There are no devices defined for the generic name specified on a UNITNAME 
statement. 


System Action: The MVS configuration program ignores the UNITNAME statement and 
continues normal processing. 


System Programmer Response: To correct this problem, do one of the following: 

e Include an IODEVICE statement that defines a device belonging to the generic name 
@e Remove the UNITNAME statement from the input stream 

DUPLICATE DEVPREF PARAMETER (generic-name) IGNORED. 


Explanation: The same generic name appeared more than once on the DEVPREF parameter of 
the EDT statement. 


System Action: The MVS configuration program treats the name as if it appeared only once. 
Processing continues normally. 


System Programmer Response: To avoid receiving this message in the future, remove the 

duplicate generic name from the UNITNAME statement. 

EDT xx: UNIT SPECIFICATION FOR (esoteric-name) CAUSES UNIT NUMBER(S) ) 
GREATER THAN limit. 


Explanation: The device number exceeds the current allowable maximum device number, limit. 
The device number was generated by a replication factor. 


System Action: The MVS configuration program performs a syntax check and a semantics check 
on the rest of the input statements. The MVS configuration program does not write the I/O 
configuration to the output data set, however. 

System Programmer Response: Correct the statement that is in error and rerun the job. 

UNIT SPECIFICATION FOR (esoteric-name) IGNORED. (device-number) IS A 
NON-ACCESSIBLE DEVICE. 


Explanation: A device number specified on a UNITNAME statement is a non-base exposure of a 
multiple exposure device. You can specify base exposures only on UNITNAME statements. 


System Action: The MVS configuration program omits this device number from the EDT and 
processing continues normally. 


System Programmer Response: If the resulting I/O configuration is acceptable, no action is 
required. Otherwise, correct the statement that is in error, and rerun the job. 
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CBP250I 


CBP2511 


CBP252I 


CBP2531 


EDT id: NOT ALL COMPATIBLE GENERICS GENERATED. INSUFFICIENT GROUP 
DESCRIPTOR TABLE ENTRIES. 


Explanation: For EDT id, there are insufficient entries in the Group Descriptor Table to store 
information on compatible generics. 


System Action: Processing continues normally. However, no more compatible generics are 
generated. 


System Programmer Response: Verify all of the generics in the list. 
MORE THAN ONE ATTEMPT BY UIMS TO BUILD A DIT FOR GENERIC DEVICE 
TYPE value. 


Explanation: The UIMs made multiple attempts to build a device information table (DIT) for 
the indicated generic device type. 


System Action: MVS configuration program execution terminates with system ABEND ‘088’X 
and with reason code ‘251’X. 


System Programmer Response: If the problem is in an installation-provided UIM, correct the 
problem and rerun the job. 


If you suspect that the problem is in an IBM-provided UIM (or in other IBM-provided MVS 
configuration program code), refer to the book MVS/Extended Architecture MVS Configuration 
Program: Diagnostic Guide for diagnostic instructions. 


EDT id: DEVICE FEATURES TABLE FOR DEVICE device NOT FOUND. 


Explanation: The report routine was attempting to find the device type for device device. The 
device was represented in EDT id but did not have a DFT. 


System Action: MVS configuration program execution terminates with a system ABEND ‘088’X 
and with reason code ‘252’X. 


System Programmer Response: Refer to the diagnostic procedures explained in the book 
MVS/Extended Architecture MVS Configuration Program: Diagnostic Guide. 
EDT id: DEVICE INFORMATION TABLE FOR GENERIC generic-name NOT FOUND. 


Explanation: The EDT Build Routine Part One was attempting to find the device information 
table for the specified generic, but no device information table (DIT) exists. 


System Action: MVS configuration program execution terminates with system ABEND ‘088’X 
and with reason code ‘253’X. 


System Programmer Response: Refer to the diagnostic procedures explained in the book 
MVS/Extended Architecture MVS Configuration Program: Diagnostic Guide. 
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CBP254I 


CBP255I 


CBP330I 


DUPLICATE GENERIC PREFERENCE FOUND IN UIMS FOR (generic-name) AND 
(generic-name). 


Explanation: Two UIMs specified the same generic priority. This message is accompanied by an 
ABEND code ‘088’X and a reason code ‘254’X. 


System Action: MVS configuration program processing terminates. 

System Programmer Response: If the problem is in an installation-provided UIM, change the 
generic priority in the UIM to an unused priority, reassemble and relink the UIM, and rerun the 
job. 

If the problem is in an IBM-provided UIM, refer to the diagnostic procedures in the book 
MVS/Extended Architecture MVS Configuration Program: Diagnostic Guide. 

THE COMPATIBLE-LIST FOR (name) CONTAINS DUPLICATE GENERIC DEVICE 
NAMES. 


Explanation: The named UIM specified a compatible list that contained duplicate devices. 


System Action: MVS configuration program execution terminates with system ABEND ‘088’X 
and reason code °255’X. 


System Programmer Response: If the problem is in an IBM-supplied UIM, contact your IBM 
representative. Otherwise check the UIM. The list of compatible generic devices contains one of 


the following: 


e A reference to itself 
e Two references to the same generic device type. 


Remove the duplicate reference, and rerun the job. 


device DEVICE NOT RECOGNIZED 


Explanation: None of the UIMs recognize the UNIT parameter that is specified on the indicated 
IODEVICE statement. 


System Action: The MVS configuration program performs a syntax check and a semantics check 
on the input stream statements. The MVS configuration program does not write the I/O 
configuration to the output data set, however. 


System Programmer Response: One of the following actions should correct the problem: 


e If you have incorrectly coded the UNIT parameter, either recode the parameter or remove 
the statement from the input stream. Rerun the job. 


e Ifthe UNIT parameter is correctly coded, provide a UIM that recognizes the UNIT 
parameter. This may require you to write a UIM or to install the product that provides the 
required UIM. Rerun the job. 
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CBP3311 


CBP332I 


CBP333I 


DEVICE NUMBER device-number WAS ALSO SPECIFIED ON STATEMENT nnnnonn 


Explanation: The same device number was specified on both of the indicated IODEVICE 
statements. 


System Action: The MVS configuration program performs a syntax check and a semantics check 
on the input stream statements. The MVS configuration program does not write the I/O 
configuration to the output data set, however. 

System Programmer Response: Change the device number on one of the statements and rerun the 
job. 

NO DIT FOUND FOR GENERIC generic SPECIFIED IN THE DFP BY UIM UIM-name 
Explanation: CBPIDFT was unable to find a device information table (DIT) for the generic 
specified in the device features parameter list (DFP) by the indicated UIM. There is probably a 


logic error in the named UIM. 


System Action: MVS configuration program execution terminates with an ABEND code of 
‘O88’X and a reason code of °332’X. 


System Programmer Response: If the problem is in an installation-provided UIM, correct the 
problem and rerun the job. 


If you suspect that the problem is in an IBM-provided UIM (or in other IBM-provided MVS 
configuration program code), refer to the book MVS/Extended Architecture MVS Configuration 
Program: Diagnostic Guide for diagnostic instructions. 


I/O ERROR ENCOUNTERED ON BLDL PROCESSING 


Explanation: A return code of 8 was encountered on the BLDL while trying to load MVS 
configuration program UIM modules. 


System Action: MVS configuration program execution terminates. 
System Programmer Response: Refer to the diagnostic procedures explained in the book 


MVS/Extended Architecture MVS Configuration Program: Diagnostic Guide. After the problem 
is fixed, rerun the job. 
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CBP334I 


CBP3351 


CBP336I 


UIM UIM-name SPECIFIED INVALID UCB SEGMENT TYPE type FOR AN ACON 
POSITION POINTER ) | 


Explanation: The named UIM specified an invalid UCB segment type for an ACON position 
pointer. There is probably a logic error in the named UIM. 


System Action: MVS configuration program execution terminates with an ABEND code of 
‘O88’X and a reason code of ‘334’X. 


System Programmer Response: If the problem is in an installation-provided UIM, correct the 
problem and rerun the job. 


If you suspect that the problem is in an IBM-provided UIM (or in other IBM-provided MVS 
configuration program code), refer to the book MVS/Extended Architecture MVS Configuration 
Program: Diagnostic Guide for diagnostic instructions. 


UIM UIM-name SPECIFIED INVALID UCB SEGMENT TYPE type FOR AN ACON 
RELOCATION POINTER 


Explanation: The named UIM specified an invalid UCB segment type for an ACON relocation 
pointer. There is probably a logic error in the named UIM. 


System Action: MVS configuration program execution terminates with an ABEND code of 
‘088"X and a reason code of ‘335’X. 


System Programmer Response: If the problem is in an installation-provided UIM, correct the 
problem and rerun the job. ) 


If you suspect that the problem is in an IBM-provided UIM (or in other IBM-provided MVS 
configuration program code), refer to the book MVS/Extended Architecture MVS Configuration 
Program: Diagnostic Guide for diagnostic instructions. 


RESIDENT ERP NAMES name AND name SPECIFIED FOR TABLE INDEX nn 


Explanation: A pair of Resident ERP Table index values match but the associated Resident ERP 
names do not match. 


System Action: MVS configuration program execution terminates with an ABEND code of 
‘088"X and a reason code of ‘336’X. 


System Programmer Response: Refer to the diagnostic procedures explained in the book 
MVS/Extended Architecture MVS Configuration Program: Diagnostic Guide. 
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CBP338I 


CBP339I 
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NO IODEVICE STATEMENTS WERE SPECIFIED 


Explanation: The MVS configuration program processed the input statements but found no 
IODEVICE statements. 


System Action: MVS configuration program execution terminates. 

System Programmer Response: Add IODEVICE statements to the input stream, and rerun the 
job. 

UIM UIM-name SPECIFIED AN INVALID OFFSET FOR AN ACON POSITION POINTER 


Explanation: The named UIM specified an offset for an ACON position pointer that was not 
within the specified UCB segment. There is probably a logic error in the named UIM. 


System Action: MVS configuration program execution terminates with an ABEND code of 
‘088’X and a reason code of °338’X. 


System Programmer Response: If the problem is in an installation-provided UIM, correct the 
problem and rerun the job. 


If you suspect that the problem is in an IBM-provided UIM (or in other IBM-provided MVS 


configuration program code), refer to the book MVS/Extended Architecture MVS Configuration 
Program: Diagnostic Guide for diagnostic instructions. 


DCQ ELEMENT NOT FOUND FOR UCB WITH UCBTBYT3 FIELD xx. UIM uim-name 
SPECIFIED THE UCBTBYT3 DATA. 


Explanation: A UCB was encountered and it did not belong to any of the device classes on the 
DCQ. There is probably a logic error in the named UIM. 


System Action: MVS configuration program execution terminates with an ABEND code of 
‘O88"X and a reason code of *339’X. 


System Programmer Response: If the problem is in an installation-provided UIM, correct the 
problem and rerun the job. 


If you suspect that the problem is in an IBM-provided UIM (or in other IBM-provided MVS 
configuration program code), refer to the book MVS/Extended Architecture MVS Configuration 
Program: Diagnostic Guide for diagnostic instructions. 


INVALID DEVICE NUMBER device-number SPECIFIED. 


Explanation: The designated IODEVICE statement specified a device number that is greater than 
4095. 


System Action: The MVS configuration program performs a syntax check and a semantics check 
on the input stream statements. The MVS configuration program does not write the I/O 


configuration to the output data set, however. 


System Programmer Response: Correct the device number specification and rerun the job. 
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CBP341I 
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CBP343I 


PROCESSING TERMINATED BECAUSE THE IIT IS TOO LARGE TO BE LOADED BY 
TEAIPL40 


Explanation: The IPL information table (IIT) Build Routine built an IIT whose size was greater 
than 4K. 


System Action: MVS configuration program execution terminates with an ABEND code of 
‘088’X and a reason code of ‘341’X. 


System Programmer Response: Refer to the diagnostic procedures explained in the book 
MVS/Extended Architecture MVS Configuration Program: Diagnostic Guide. 


UIM UIM-name SPECIFIED INVALID DEVICE NUMBER device-number IN THE 
RELOCATION INFORMATION 


Explanation: The named UIM specified a device number greater than the maximum number 
allowed. The number was specified in the relocation information for a device. There is probably 
a logic error in the named UIM. 


System Action: MVS configuration program execution terminates with an ABEND code of 
‘088’X and a reason code of ‘342’X. 


System Programmer Response: If the problem is in an installation-provided UIM, correct the 
problem and rerun the job. 


If you suspect that the problem is in an IBM-provided UIM (or in other IBM-provided MVS 
configuration program code), refer to the book MVS/Extended Architecture MVS Configuration 
Program: Diagnostic Guide for diagnostic instructions. 


UIM UIM-name SPECIFIED DEVICE NUMBER device-number IN THE RELOCATION 
INFORMATION BUT NO DFT WAS FOUND FOR THIS DEVICE NUMBER 


Explanation: The named UIM specified, in the relocation information, a device number that was 
not defined on an IODEVICE statement. There is probably a logoc error in the named UIM. 


System Action: MVS configuration program execution terminates with an ABEND code of 
‘088’X and a reason code of 343’X. 


System Programmer Response: If the problem is in an installation-provided UIM, correct the 
problem and rerun the job. 


If you suspect that the problem is in an IBM-provided UIM (or in other IBM-provided MVS 
configuration program code), refer to the book MVS/Extended Architecture MVS Configuration 
Program: Diagnostic Guide for diagnostic instructions. 
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THE DCT INFORMATION SPECIFIED FOR DASD TYPE type DOES NOT MATCH THE 
PREVIOUSLY SPECIFIED INFORMATION FOR THIS DASD TYPE 


Explanation: A UIM supplied device characteristics information to CBPDDCT that was 
inconsistent with previously specified information. 


System Action: MVS configuration program execution terminates with an ABEND code of 
‘088’X and a reason code of ‘344’X. 


System Programmer Response: Refer to the diagnostic procedures explained in the book 
MVS/Extended Architecture MVS Configuration Program: Diagnostic Guide. 


SPECIFIED LENGTH OF DCT ENTRY IS GREATER THAN THE MAXIMUM POSSIBLE 
LENGTH 


Explanation: A UIM specified length for a device charactenstics table (DCT) entry was greater 
than the maximum possible length. 


System Action: MVS configuration program execution terminates with an ABEND code of 
‘088’ and a reason code of ‘345’X. 


System Programmer Response: Collect any data that will help you isolate the problem to a 
component or module. If the problem is in IBM-supplied code, contact your IBM 
representative. If the problem is in an installation-provided UIM and you need information 
about UIMs, see MV S/Extended Architecture System Programming Library: System 
Modifications. After the problem is fixed, rerun the job. 


INSUFFICIENT SPACE IN DCT FOR CURRENT DCT ENTRY 


Explanation: A UIM attempted to add an entry to the device characteristics table (DCT). 
Adding that entry would cause the size of the DCT to exceed the maximum possible size. 


System Action: MVS configuration program execution terminates with an ABEND code of 
‘088’X and a reason code of ‘346’X. 


System Programmer Response: Refer to the diagnostic procedures explained in the book 
MVS/Extended Architecture MVS Configuration Program: Diagnostic Guide. 
THE MLT NAME LIST INFORMATION SPECIFIED FOR MLT NAME name DOES NOT 


MATCH THE PREVIOUSLY SPECIFIED INFORMATION FOR THIS MLT NAME 


Explanation: A module list table (MLT) name was specified more than once, at least one time as 
being optional and at least one time as being required. 


System Action: MVS configuration program execution terminates with an ABEND code of 
‘088’ and a reason code of ‘347’X. 


System Programmer Response: Refer to the diagnostic procedures explained in the book 
MVS/Extended Architecture MVS Configuration Program: Diagnostic Guide. 
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UIM UIM name SPECIFIED A NUMBER OF MLT NAMES WHICH IS (MORE | LESS) 
THAN THE (MAXIMUM | MINIMUM) ALLOWED 


Explanation: The named UIM either specified more than five MLT names or specified no MLT 
names. 


System Action: The MVS configuration program terminates execution with an ABEND code of 
‘088’X and a reason code of ‘348’X. 


System Programmer Response: If the problem is in an installation-provided UIM, correct the 
problem and rerun the job. 


If you suspect that the problem is in an IBM-provided UIM (or in other IBM-provided MVS 
configuration program code), refer to the book MVS/Extended Architecture MVS Configuration 
Program: Diagnostic Guide for diagnostic instructions. 


UIM UIM name SPECIFIED MORE THAN THE MAXIMUM ALLOWED AMOUNT OF 
DEVICE DEPENDENT INFORMATION 


Explanation: The named UIM specified more than 256 bytes of device-dependent information. 
There is probably a logic error in the named UIM. 


System Action: The MVS configuration program terminates execution with an ABEND code of 
‘088’X and a reason code of *349’X. 


System Programmer Response: If the problem is in an installation-provided UIM, correct the 
problem and rerun the job. 


If you suspect that the problem is in an IBM-provided UIM (or in other IBM-provided MVS 
configuration program code), refer to the book MV S/Extended Architecture MVS Configuration 
Program: Diagnostic Guide for diagnostic instructions. 


REQUIRED PARAMETER parameter NOT SPECIFIED FOR device DEVICE 


Explanation: A parameter required for the specified device was not specified on the IODEVICE 
statement. 


System Action: The MVS configuration program performs a syntax check and a semantics check 
on the input stream statements. The MVS configuration program does not write the I/O 


configuration to the output data set, however. 


System Programmer Response: Correct the IODEVICE statement and rerun the job. 
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THE parameter/feature PARAMETER/FEATURE IS IGNORED 


Explanation: Either an IODEVICE statement parameter that is not allowed was specified, or an 
obsolete feature was specified. 


System Action: The MVS configuration program ignores the parameter or feature specification 
and continues to execute in the current mode. 


System Programmer Response: To avoid receiving this message in the future, remove the 
parameter or feature specification from the IODEVICE statement. 
FEATURE feature NOT RECOGNIZED FOR device DEVICE 


Explanation: A unrecognized feature was specified on the IODEVICE statement that defines the 
indicated device. 


System Action: The MVS configuration program performs a syntax check and a semantics check 
on the input stream statements. The MVS configuration program does not write the I/O 


configuration to the output data set, however. 


System Programmer Response: Correct the IODEVICE statement and rerun the job. 


FEATURE feature WAS SPECIFIED MORE THAN ONCE 

Explanation: A feature was specified more than once on the indicated IODEVICE statement. 
System Action: The MVS configuration program performs a syntax check and a semantics check 
on the input stream statements. The MVS configuration program does not write the I/O 
configuration to the output data set, however. 

System Programmer Response: Correct the I|ODEVICE statement and rerun the job. 

UIM UIM name RECOGNIZES MORE THAN THE MAXIMUM NUMBER OF FEATURES 
ALLOWED 


Explanation: A UIM indicated that it recognized more than 64 features. There is probably a 
logic error in the named UIM. 


System Action: MVS configuration program execution terminates with a system ABEND of 
‘088’X and a reason code of °354’X. 


System Programmer Response: If the problem is in an installation-provided UIM, correct the 
problem and rerun the job. 


If you suspect that the problem is in an IBM-provided UIM (or in other IBM-provided MVS 


configuration program code), refer to the book MVS/Extended Architecture MVS Configuration 
Program: Diagnostic Guide for diagnostic instructions. 
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CBP402I 





UIM UIM name DID NOT CAUSE ANY DFTS TO BE BUILT FOR A VALID IODEVICE 
STATEMENT 


| 
Explanation: The named UIM processed an IODEVICE statement, detected no errors on the > 
statement, but failed to build any DFTS. There is probably a logic error in the named UIM. 


System Action: MVS configuration program execution terminates with a system ABEND of 
“088"X and a reason code of ‘355’X. 


System Programmer Response: If the problem is in an installation-provided UIM, correct the 
problem and rerun the job. 


If you suspect that the problem is in an IBM-provided UIM (or in other IBM-provided MVS 


configuration program code), refer to the book MVS/Extended Architecture MVS Configuration 
Program: Diagnostic Guide for diagnostic instructions. 


THE device AND device DEVICES SHOULD BOTH BE SPECIFIED OR OMITTED FROM 
THE I/O CONFIGURATION DEFINITION 


Explanation: If both of the devices are not specified in the configuration definition, MVS will be 
unable to use either device. 


System Action: Processing continues in the current mode. This message is issued as a warning. 


System Programmer Response: Correct the device specification and rerun the job. 


model IS NOT A VALID MODEL NUMBER FOR THE device DEVICE J 
Explanation: The specified model number is invalid for the indicated device. 

System Action: The MYS configuration program performs a syntax check and a semantics check 

on the input stream statements. The MVS configuration program does not write the I/O 

configuration to the output data set, however. 

System Programmer Response: Correct the model number specification on the IODEVICE 

statement and rerun the job. 


ONLY ONE KEYBOARD MAY BE SPECIFIED 


Explanation: The device supports multiple keyboards. Only one may be specified per device, 
however. . 


System Action: The MVS configuration program performs a syntax check and a semantics check 
on the input stream statements. The MVS configuration program does not write the I/O 
configuration to the output data set, however. 


System Programmer Response: Correct the keyboard specification on the IODEVICE statement 
and rerun the job. 


10-26 MVS/XA MVS Configuration Program Guide and Reference 


i 


CBP4031 
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MORE THAN ONE CHARACTER GENERATOR SPECIFIED 


Explanation: The device supports multiple character sets. Only one may be specified per device, 
however. 


System Action: The MVS configuration program performs a syntax check and a semantics check 
on the input stream statements. The MVS configuration program does not write the I/O 
configuration to the output data set, however. 


System Programmer Response: Correct the character generator specification on the IODEVICE 
statement and rerun the job. 
MORE THAN ONE KEY TYPE SPECIFIED 


Explanation: The device supports multiple key types. Only one may be specified per device, 
however. 


System Action: The MVS configuration program performs a syntax check and a semantics check 
on the input stream statements. The MVS configuration program does not write the I/O 
configuration to the output data set, however. 


System Programmer Response: Correct the keyboard type specification on the IODEVICE 
statement and rerun the job. 

FEATURES feature] AND feature2 ARE MUTUALLY EXCLUSIVE FOR THE device 
DEVICE 

Explanation: These features cannot be specified together for the device. 

System Action: The MVS configuration program performs a syntax check and a semantics check 
on the input stream statements. The MVS configuration program does not write the I/O 
configuration to the output data set, however. 

System Programmer Response: Delete one of the feature specifications from the IODEVICE 
statement and rerun the job. 

ADDRESS device-number SPECIFIED FOR THE 3350P. THE NEXT TO LOW ORDER 
DIGIT MUST BE EVEN. 


Explanation: The next-to-low order digit (that is the middle digit) of the 3-digit device number 
must be even (0, 2, 4, 6, 8, A, C, or E). 


System Action: The MVS configuration program performs a syntax check and a semantics check 
on the input stream statements. The MVS configuration program does not write the I/O 


configuration to the output data set, however. 


System Programmer Response: Correct the device number specification on the IODEVICE 
statement and rerun the job. 
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CBP408I 


CBP409I 


CBP4101 


CBP411I 





ADDRESS device-number SPECIFIED FOR THE device. THE SUM OF THE LOW ORDER 
DIGIT PLUS THE REPLICATION FACTOR MUST BE LESS THAN {NINE | FIVE} 


Explanation: The base UCB device-numbers extend beyond the allowable range of 
device-numbers. For a 3350P the allowable range is 32; for a 3351P the allowable range is 16. 


The sum of the low order digit of the device number plus the replication factor (also called the 
number-of-units on the IODEVICE statement) must be: 


e Less than nine (9) for a 3350P 
e Less than five (5) for a 3351P 


System Action: The MVS configuration program performs a syntax check and a semantics check 
on the input stream statements. The MVS configuration program does not write the I/O 
configuration to the output data set, however. 

System Programmer Response: Correct the ADDRESS= parameter on the IODEVICE 
statement and rerun the job. 

parameter PARAMETER IS IGNORED FOR THE device MODEL model 

Explanation: The specified parameter is ignored for this particular model of the device device. 
System Action: Processing continues in the current mode. 

System Programmer Response: To avoid receiving this message in the future, remove the 
specified parameter from the IODEVICE statement. 

FEATURE feature] REQUIRES THAT FEATURES feature2 AND feature3 BE SPECIFIED, 


OR THAT FEATURES feature4 AND feature’ BE SPECIFIED 


Explanation: The required combination of features was not specified. When feature featurel is 
specified, either feature2 and feature3, or feature4 and feature5 must be specified. 


System Action: The MVS configuration program performs a syntax check and a semantics check 
on the input stream statements. The MVS configuration program does not write the I/O 


configuration to the output data set, however. 


System Programmer Response: Specify the required combination of features and rerun the job. 


FEATURE AUDALRM REQUIRES A KEYBOARD 

Explanation: When AUDALRM feature is specified, a keyboard must also be specified. 

System Action: The MVS configuration program performs a syntax check and a semantics check 
on the input stream statements. The MVS configuration program does not write the I/O 


configuration to the output data set, however. 


System Programmer Response: Add a keyboard specification to the indicated IODEVICE 
statement, or remove the audible alarm specification from the statement. Rerun the job. 
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FEATURE feature] REQUIRES THAT FEATURES feature2 AND feature3 BE SPECIFIED 
Explanation: When feature feature] is specified, the other named features must also be specified. 
System Action: The MVS configuration program performs a syntax check and a semantics check 
on the input stream statements. The MVS configuration program does not write the I/O 
configuration to the output data set, however. 

System Programmer Response: Add the required feature specifications to the IODEVICE 
statement, or remove the specification for feature feature]. Rerun the job. 

FEATURE DATACONV REQUIRES THAT FEATURE 7-TRACK BE SPECIFIED FOR THE 
3420 MODELS 3, 5 OR 7 TAPE 


Explanation: When feature DATACONYV is specified, the feature 7-TRACK must also be 
specified. 


System Action: The MVS configuration program performs a syntax check and a semantics check 
on the input stream statements. The MVS configuration program does not write the I/O 
configuration to the output data set, however. 

System Programmer Response: Add the 7-track feature to the IODEVICE statement, or remove 
the DATACONV feature from the statement. Rerun the job. 

THE DEFAULT REPLICATION FACTOR FOR THE device DEVICE IS TWO. 


Explanation: The replication factor (also called the number-of-units on the IODEVICE statement) 
was omitted. For the indicated device, the replication factor defaults to two. 


System Action: Processing continues in the current mode. 


System Programmer Response: None. 


value IS NOT VALID FOR THE parameter PARAMETER FOR THE device DEVICE 
Explanation: An invalid parameter value was specified for the indicated device. 

System Action: The MVS configuration program performs a syntax check and a semantics check 
on the input stream statements. The MVS configuration program does not write the I/O 


configuration to the output data set, however. 


System Programmer Response: Correct the IODEVICE statement and rerun the job. 
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CBP420I 


parameter] PARAMETER REQUIRES parameter2 PARAMETER FOR THE device DEVICE 


Explanation: When the parameter] parameter is specified, the parameter2 parameter must also be 
specified for the indicated device. 


System Action: The MVS configuration program performs a syntax check and a semantics check 
on the input stream statements. The MVS configuration program does not write the I/O 
configuration to the output data set, however. 


System Programmer Response: Either add the parameter2 parameter to the IODEVICE 
statement, or remove the parameter] parameter. Rerun the job. 

value VALUE IS NOT VALID FOR THE parameter] PARAMETER WHEN THE parameter2 
PARAMETER HAS VALUE OF value 

Explanation: Incompatible values have been specified for two different parameters. 

System Action: The MVS configuration program performs a syntax check and a semantics check 
on the input stream statements. The MVS configuration program does not write the I/O 
configuration to the output data set, however. 

System Programmer Response: Change the parameter values on the IODEVICE statement so 
they do not conflict and rerun the job. 


DEVICE NUMBER DOES NOT END IN ZERO 


Explanation: The device number for the device defined on the indicated IODEVICE statement 
does not have a low-order digit of 0. 


System Action: The MVS configuration program performs a syntax check and a semantics check 
on the input stream statements. The MVS configuration program does not write the I/O 
configuration to the output data set, however. 


System Programmer Response: Change the device number on the IODEVICE statement so it has 
a low-order digit of 0 and rerun the job. 

FEATURE feature] CANNOT BE SPECIFIED WITH EITHER FEATURES /feature2, feature3, 
OR feature4 

Explanation: Mutually exclusive features have been specified on an IODEVICE statement. 
System Action: The MVS configuration program performs a syntax check and a semantics check 
on the input stream statements. The MVS configuration program does not write the I/O 


configuration to the output data set, however. 


System Programmer Response: Correct the feature specification on the IODEVICE statement and 
rerun the job. 
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FEATURE feature] REQUIRES THAT FEATURE feature2 IS SPECIFIED 
Explanation: Feature feature] cannot be specified unless you also specify featured. 


System Action: The MVS configuration program performs a syntax check and a semantics check 
on the input stream statements. The MVS configuration program does not write the I/O 
configuration to the output data set, however. 


System Programmer Response: Change the IODEVICE statement to include the required feature, 
or else delete feature]. Then rerun the job. 


FEATURE feature] CANNOT BE SPECIFIED WITH EITHER FEATURES /f/eature2 OR 
feature3 


Explanation: Mutually exclusive features have been specified on the IODEVICE statement. 


System Action: The MVS configuration program performs a syntax check and a semantics check 
on the input stream statements. The MVS configuration program does not write the I/O 
configuration to the output data set, however. 


System Programmer Response: Correct the IODEVICE statement to specify a valid combination 
of features and rerun the job. 


FEATURE feature IS NOT VALID WITH A TCU VALUE OF value 


Explanation: The indicated IODEVICE statement specifies a feature and a TCU value that are 
mutually exclusive. 


System Action: The MVS configuration program performs a syntax check and a semantics check 
on the input stream statements. The MVS configuration program does not write the I/O 
configuration to the output data set, however. 


System Programmer Response: Remove the feature specification or change the value of the TCU 
and rerun the job. 


MORE GUARANTEED BUFFERS REQUESTED THAN ARE SUPPORTED IN THE 
DEVICE BUFFER TABLE FOR THE PCU pcu-number 


Explanation: The NUMSECT= parameter on the IODEVICE statements for 2250s has 
requested more guaranteed buffer sections than are available in that table. The affected PCU is 
pcu-number. 


System Action: The MVS configuration program performs a syntax check and a semantics check 
on the input stream statements. The MVS configuration program does not write the I/O 


configuration to the output data set, however. 


System Programmer Response: Change the IODEVICE statements for the 2250s to reduce the 
amount of request buffer space and rerun the job. 
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CBP4281 


CBP4291 





MORE THAN FOUR DEVICES REQUESTED PCU id 


Explanation: More than four IODEVICE statements for 2250s have specified the same physical ) 
control unit. Each physical control unit can support no more than four 2250s. 


System Action: The MVS configuration program performs a syntax check and a semantics check 
on the input stream statements. The MVS configuration program does not write the I/O 
configuration to the output data set, however. 


System Programmer Response: Change the PCU parameter on the IODEVICE statements for the 
2250s so that no more than four 2250s specify the same physical control unit. Rerun the job. 


THE MINIMUM REPLICATION FACTOR FOR THE device DEVICE IS TWO. 


Explanation: The replication factor (also called the number-of-units on the IODEVICE statement) 
was either omitted or was assigned a value of one. For this device, the replication factor must be 
at least two. 


System Action: The MVS configuration program defaults the replication factor to two and 
processing continues in the current mode. 


System Programmer Response: To avoid receiving this message in the future, change the 
indicated IODEVICE statement to specify the correct replication factor. 


FEATURE PARAMETER IS IGNORED FOR THE BSC1 DEVICE UNLESS TCU =2701 IS 


SPECIFIED. ) 


Explanation: The feature parameter was specified on the indicated IODEVICE statement without 
TCU =2701 being specified. 


System Action: Processing continues in the current mode. 


System Programmer Response: To avoid receiving this message in the future, remove the 
FEATURE parameter from the indicated IODEVICE statement or specify a different TCU 
value. 


REPLICATION FACTOR OF ONE IS USED. EIGHT DEVICE NUMBERS DEFINED. 


Explanation: The ADDRESS parameter on the indicated IODEVICE statement specified a 
replication factor (also called number-of-units on the IODEVICE statement) greater than one. 
This device requires a replication factor of one which causes the MVS configuration program to 
define eight device numbers. 


System Action: The MVS configuration program defaults the replication factor to one. 
Processing continues in the current mode. 


System Programmer Response: To avoid receiving this message in the future, change the 
replication factor to one on the indicated IODEVICE statement. 
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device] AND device2 CANNOT BOTH BE DEFINED FOR THE SAME CONFIGURATION. 


Explanation: The specified devices are mutually exclusive and cannot be defined in the same 
configuration. 


System Action: The MVS configuration program performs a syntax check and a semantics check 
on the input stream statements. The MVS configuration program does not write the I/O 
configuration to the output data set, however. 

System Programmer Response: Remove the IODEVICE statement for one of the devices and 
rerun the job. 

CHECKING FEATURE REQUIRED WITH 2740C AND 2740X 

Explanation: Checking is a required feature for the specified devices. 

System Action: The MVS configuration program performs a syntax check and a semantics check 
on the input stream statements. The MVS configuration program does not write the I/O 
configuration to the output data set, however. 

System Programmer Response: Include the CHECKING feature on the IODEVICE statements 
for these devices and rerun the job. 

parameter! PARAMETER IS IGNORED FOR THE device WHEN THE parameter2 
PARAMETER IS SPECIFIED. 


Explanation: Incompatible parameters, parameter] and parameter2, were specified on the 
IODEVICE statement for the named device. 


System Action: The MVS configuration program uses parameter2 instead of parameter] and 
continues processing in the current mode. 


System Programmer Response: 
e If you want to use parameter2, no action is required. 


e If you want to use parameter2 and wish to avoid receiving this message in the future, remove 
parameter! from the IODEVICE statement. 


e If you want to use parameter], remove parameter2 from the IODEVICE statement and then 
rerun the job. 
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parameter! IS IGNORED FOR THE device WHEN THE parameter2 PARAMETER IS NOT 
SPECIFIED. 


Explanation: A parameter, parameter], was coded on an IODEVICE statement, however, a J 
required companion parameter, parameter2, was not coded on the IODEVICE statement. 


System Action: The MVS configuration program ignores parameter] and continues processing in 
the current mode. 


System Programmer Response: Either remove parameter] from the IODEVICE statement, or 
code both parameter] and parameter2 on the IODEVICE statement. If you code both 
parameters, also rerun the job. 

FEATURE feature] REQUIRES THAT FEATURES feature2 OR feature3 BE SPECIFIED 
Explanation: When feature! is specified, feature2, or feature3, or both must also be specified. 
System Action: The MVS configuration program performs a syntax check and a semantics check 
on the input stream statements. The MVS configuration program does not write the I/O 
configuration to the output data set, however. 

System Programmer Response: Add the required feature specifications to the IODEVICE 
statement, or remove the specification for feature feature]. Rerun the job. 


NO NIPCON STATEMENTS WERE SPECIFIED 


Explanation: The MVS configuration program input stream must include at least one NIPCON J 
statement. 


System Action: The MVS configuration program performs a syntax check and a semantics check 
on the input stream statements. The MVS configuration program does not write the I/O 
configuration to the output data set, however. 


System Programmer Response: Include a NIPCON statement in the input stream and rerun the 
job. 
NIPCON STATEMENT SPECIFIED UNDEFINED DEVICE NUMBER device-number 


Explanation: The indicated device number was specified as a NIP console device, but the input 
stream contained no IODEVICE statement for the device. 


System Action: The MVS configuration program performs a syntax check and a semantics check 
on the input stream statements. The MVS configuration program does not write the I/O 
configuration to the output data set, however. 


System Programmer Response: Either remove the device number from the NIPCON statement or 
include an IODEVICE statement for the device. Rerun the job. 
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c 


CBPS502I 


CBP5031 


CBP6001 


DEVICE NUMBER device-number CANNOT BE USED AS A NIP CONSOLE DEVICE. THIS 
DEVICE WAS DEFINED BY STATEMENT annnnn 


Explanation: The indicated device number was specified as a NIP console device. MVS does not 
support that device as a NIP console, however. 


System Action: The MVS configuration program performs a syntax check and a semantics check 
on the input stream statements. The MVS configuration program does not write the I/O 
configuration to the output data set, however. 

System Programmer Response: Change the NIPCON statement or the IODEVICE statement to 


specify a device that MVS supports as a NIP console, and rerun the job. For a list of devices 
that you can define as NIP consoles, see “Defining NIP Consoles” on page 7-9. 


DEVICE NUMBER device-number WAS PREVIOUSLY SPECIFIED AS A NIP CONSOLE 
DEVICE ON STATEMENT nrannnn. THE DUPLICATE SPECIFICATION IS IGNORED. 
Explanation: The indicated device number was previously specified as a NIP console device. 


System Action: The first NIP console definition statement for this device is used. Others are 
ignored. 


System Programmer Response: To avoid receiving this message in the future, remove the 
duplicate NIPCON definition. 
JES3 PROCESSING OF EDT id COMPLETE. 


Explanation: JES3 data for the indicated EDT as well as for the I/O configuration has been 
successfully generated. 


System Action: Processing continues normally. 


System Programmer Response: None. 


CBP900 to CBP999 


Explanation: These messages are reserved for installations to use when they write their own 
UIMs. Therefore, they are not documented in IBM publications. 
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Appendix A. Generic Device Types 


Array Processor 


The MVS configuration program logically groups devices with similar allocation 
characteristics into groups called generic device types. The MVS configuration 
program then assigns each group a name called the groups “generic name.” 
Certain parameter values that you code on an IODEVICE statement determines 
the generic name assigned to the corresponding device. To determine which 
generic name to assign, the MVS configuration program uses the UNIT 
parameter and in some cases the MODEL and FEATURE parameters. Other 
parameters can appear on the IODEVICE statement but are not used to 
determine the generic name. 


This appendix contains a set of tables that identifies generic names. For each 
generic name the tables also identify the IODEVICE parameter values that cause 
a device to be assigned the corresponding generic name. Each table contains: 


e In the left column -- a generic name. When a table contains more than one 
name, the names are arranged alphabetically. 


e In the right column -- the IODEVICE statement parameter values that cause 
the MVS configuration program to assign a device the corresponding generic 
name. 


The tables are arranged in ascending alphabetical order according to their 
headings (Array Processor, Channel-Channel Adapters, etc.). 


This generic name _ | includes only those devices specified as: 
3838 UNIT = 3838 


Channel-Channel Adapters 


This generic name_ | includes only those devices specified as: 
CTC UNIT=CTC 
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Cryptographic Unit 


includes only those devices specified as: 
3848 UNIT = 3848 





Direct Access 






UNIT = 3350 
UNIT = 3350P 
UNIT =3351P 


3375 UNIT = 3375 
3380 UNIT = 3380 










Diskette 


includes only those devices specified as: 
3540 UNIT = 3540 


Drum 






includes only those devices specified as: 
2305-2 UNIT = 2305,MODEL = 2 
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C 


Dummy Device 


includes only those devices specified as: 
DUMMY UNIT =DUMMY 


Graphic (display) Devices 












UNIT = 2250,MODEL = 3 
UNIT =3277,MODEL = | 
UNIT =3278,MODEL = | 


3277-2 















UNIT =3270,MODEL=X 
UNIT =3277,MODEL=2 
UNIT = 3278, MODEL = 2 
UNIT =3278,MODEL=2A 
UNIT = 3278, MODEL = 3 
UNIT = 3278,MODEL=4 
UNIT = 3279,MODEL =2A 
UNIT = 3279, MODEL = 2B 
UNIT = 3279, MODEL =2C 
UNIT = 3279, MODEL =3A 
UNIT =3279, MODEL = 3B 


UNIT = 3284,MODEL =2 
UNIT =3286,MODEL = | 
UNIT =3286,MODEL =2 











Appendix A. Generic Device Types A-3 





Magnetic Tape 


includes only those devices specified as: 
UNIT = 2400 

UNIT = 2400,MODEL = 1 
UNIT = 2400,MODEL =2 
UNIT = 2400,MODEL =3 
2400-4 


2400-4 UNIT = 2400,MODEL=4 


3400-2 UNIT = 3420,Model = 3, FEATURE =(7-TRACK,DATACONV) 
UNIT = 3420, Model = 5, FEATURE =(7-TRACK, DATACONV) 
UNIT = 3420,Model = 7, FEATURE =(7-TRACK,DATACONV) 


3400-3 UNIT = 3420,Model = 3, FEATURE = 9-TRACK 
UNIT = 3420,Model = 5, FEATURE =9-TRACK 
UNIT =3420,Model = 7, FEATURE =9-TRACK 
3400-4 UNIT = 3420,Model = 3, FEATURE = (9-TRACK, DUALDENS) 
UNIT = 3420, Model = 5, FEATURE=(9-TRACK, DUALDENS) 
UNIT = 3420,Model = 7, FEATURE=(9-TRACK, DUALDENS) 
3400-5 UNIT = 3420,Model =4, FEATURE =9-TRACK 
UNIT = 3420, Model = 6, FEATURE = 9-TRACK 
UNIT = 3420, MODEL = 8, FEATURE =9-TRACK 
3400-6 UNIT = 3420, Model = 4, FEATURE= (9-TRACK,OPT1600) 
UNIT = 3420, Model = 6, FEATU RE = (9-TRACK,OPT1600) 
UNIT = 3420, Model = 8, FEATURE=(9-TRACK,OPT1600) 


3400-9 UNIT = 3420C 


3480 UNIT = 3480 





Mass Storage Subsystem 










includes only those devices specified as: 
3330V UNIT =3330V 
3851 UNIT = 3851 
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Optical and Magnetic Character Readers 


This generic name _ | includes only those devices specified as: 
1287 UNIT = 1287 
1288 UNIT = 1288 
3886 UNIT = 3886 
3890 UNIT = 3890 
3895 UNIT = 3895 


a”) 
— 
— 
— 
= 
1?) 
— 
7) 


This generic name_ | includes only those devices specified as: 


1403 UNIT = 1403, MODEL=NI1 
UNIT = 1403, MODEL =2 
UNIT = 1403, MODEL =7 


UNIT =3203,MODEL = 4 
UNIT = 3203,MODEL=5 
UNIT =3211 


UNIT =3800,MODEL = 1 
UNIT =3800,MODEL = 3 
UNIT = 3800,Model = 8 


UNIT = 4245 | 
UNIT = 4248 





Readers and Punches 


includes only those devices specified as: 


UNIT = 2501,MODEL = Bl 
UNIT =2501,MODEL = B2 


This generic name 
2501 












Appendix A. Generic Device Types A-5 


Telecommunication Devices 
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Appendix B. IBM Provided Device Preference Table 


The following list shows the device order that MVS uses when it attempts an 
allocation to satisfy a request for a device from an esoteric device group. The 
order of the IBM-defined list ensures that MVS always tries to allocate the fastest 


possible available device. 


For each EDT that you define, you may change the order of the list. Code the 
changes on the DEVPREF = parameter of the EDT statement. 


Device Type 
drum 


direct access 


magnetic tape 


printers 


Generic Name 
2305-2 


3380 
3350 
3375 
3330-1 
3330 
3340 


3480 

3400-9 
3400-5 
3400-3 
3400-6 
3400-4 
3400-2 
2400-3 
2400 

2400-4 
2400-2 
2400-1 


3800 
4248! 
4245 
3211 
3203 
1403 


l Because the 3262 Model 5 is generated as a 4248 printer, the entry 4248 in the 
installation device preference table may refer to a 4248 printer, a 3262 Model 5 
printer, or both. If a 3262 Model 5 printer is installed on your system, and the 
4248 entry in your installation device preference table precedes the entries for the 
4245 or the 3800 printers, your system may allocate the slower 3262 Model 5 
printer in preference to the faster 4245, 4248, or 3800. 
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readers/punches 


sraphic (display) devices 


optical or magnetic character readers 


diskette 


mass storage subsystem 


array processor 


telecommunication device 


channel-to-channel CU 


telecommunication devices 


miscellaneous devices 
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2501 
3505 
3525 
2540 
2540-2 


HFGD 
2250-3 
3277-1 
3277-2 
3284-1] 
3284-2 
3286-1 
3286-2 
2260-1 
2260-2 


3890 
3886 
1287 
1288 
3895 


3540 


3851 
3330V 


3838 


AAA] 
AAA2 
AAAS 
AAA6 
AAA7 
AAAS 
AAA9 
AAAA 
AAAB 
AAAC 
AAAD 
AAAE 
AAAF 
3705 
3791L 
3704 


CTC 


AAAG 
AAAH 
AAAI 


DUMMY 


3848 


Appendix C. Determining 3350P and 3351P Device Number 
Assignments 


The values that you code on the ADDRESS= parameter of the 3350P or 3351P 
IODEVICE statement determines: 


e How many device numbers the MVS configuration program assigns to the 
device 


@ The values of the assigned device numbers 


3350P Device Number Assignments 


The ADDRESS= parameter on the IODEVICE statement that defines a 3350P 
has one of the following general forms: 


IODEVICE UNIT =3350P, ADDRESS = device-number.,... 


IODEVICE UNIT =3350P,ADDRESS = (device-number number-of-units),... 
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Use the following chart to calculate the value of the device numbers that the MVS 
configuration program assigns to a 3350P. The variable n, shown in the chart, 
represents the value of the device number that you specify on the ADDRESS = 
parameter. For example, if you code ADDRESS = (200,2), substitute 200 for n. 


If the value you specify for number-of-units is: 


e 1 or2 or is omitted, The MVS configuration program assigns the first two 
rows of device numbers shown in the chart. 


e 3, The MVS configuration program assigns the top three rows of device 
numbers shown in the chart. 


e 4, The MVS configuration program assigns the top four rows of device 
numbers shown in the chart. 


e 5, The MVS configuration program assigns the top five rows of device 
numbers shown in the chart. 


@e 6, The MVS configuration program assigns the top six rows of device 
numbers shown in the chart. 


e 7, The MVS configuration program assigns the top seven rows of device 
numbers shown in the chart. 


e 8, The MVS configuration program assigns all of the device numbers shown 
in the chart. 


a > 







3350P Base Exposures 


The device numbers shown in the leftmost column (n, n+1, n+2, etc.) are called 
the 3350P’s base exposures. If you include 3350P device numbers on a 
UNITNAME statement, you may include the base exposures only. The other 
device numbers are called the 3350P’s non-base exposures. 
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3350P Examples 


If you code ADDRESS = 000, or ADDRESS = (000,1), or ADDRESS = (000,2), 
the MVS configuration program assigns the device numbers shown below. Base 
exposures are 000 and 001. 


000 008 010 018 
001 009 O11 O19 


If you code ADDRESS = (000,8), the MVS configuration program assigns the 
device numbers shown below. Base exposures are 000, 001, 002, 003, 004, 005, 
006, and 007. 


000 008 010 018 
001 009 O11 O19 
002 OOA 012 OIA 
003 OOB 013 OI1B 
004 O00C 014 OIC 
005 00D 015 OID 
006 OOE 016 OIE 
007 OOF O17 OIF 


3351P Device Number Assignments 


The ADDRESS= parameter on the IODEVICE statement that defines a 3351P 
has one of the following general forms: 


IODEVICE UNIT =3351P,ADDRESS = device-number.,... 





IODEVICE UNIT =3351P,ADDRESS = (device-number,number-of-units),... 
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Use the following chart to calculate the value of the device numbers that the MVS 
configuration program will assign to a 3351P. The variable n, shown in the chart, ) 





represents the value of the device number that you specify on the ADDRESS = 
parameter. For example, if you code ADDRESS = (200,2), substitute 200 for n. 


If the value you specify for number-of-units is: 


e 1 or 2 or is omitted, The MVS configuration program assigns the top two 
rows of device numbers shown in the chart. 


e 3, The MVS configuration program assigns the top three rows of device 
numbers shown in the chart. 


e 4, The MVS configuration program assigns all of the device numbers shown 
in the chart. 


fae eX Cd COC~“*‘“*S SS KSSCSC“‘CC™S 






3351P Base Exposures 


The device numbers shown in the leftmost column (n, n+1, n+2, and n+3) are 

called the 3351P’s base exposures. If you include 3351P device numbers on a 

UNITNAME statement, you may include the base exposures only. The other 

device numbers are called the 3351P’s non-base exposures. J 


3351P Examples 


If you code ADDRESS = 000, or ADDRESS = (000,1), or ADDRESS = (000,2), 
the MVS configuration program assigns the device numbers shown below. Base 
exposures are 000 and 001. 


000 004 008 O0C 
001 005 009 00D 


If you code ADDRESS = (000,4), the MVS configuration program assigns the 
following device numbers. Base exposures are 000, 001, 002, and 003. 


000 004 008 O00C 
001 005 009 00D 
002 006 O0A OOE 
003 007 OOB OOF 
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PS2 


IDO2 


* 
* 


Appendix D. MVS Configuration Program Example 


The following example shows a combined IJOCP and MVS configuration program 


input stream. 


IOCONFIG ID=02 
ID MSG1='EXAMPLE CONFIGURATION ' 


CHPID PATH=00,TYPE=BY 

CHPID PATH=((01),(02),(03),(04),(05),(06),(07),(08)),TYPE=BL 
CHPID PATH=((09),(0A),(0B),(0C),(0OD),(0OE),(OF),(10)),TYPE=BL 
CHPID PATH=((11),(12),(13),(14),(15),(16),(17),(18)),TYPE=BL 
CHPID PATH=((19),(1A),(1B),(1C),(1D),(1E),(1F),(20)),TYPE=BL 
CHPID PATH=((21),(22),(23),(24),(25),(26),(27),(28)),TYPE=BL 
CHPID PATH=((29),(2A),(2B),(2C),(2D),(2E),(2F)),TYPE=BL 


KKKKKKKKKKKKKKRKRKKKKKKK UNIT ADDRESSES OOO-OFF REKKKKKKKKKKKKRKKKKKKKKAKEKE 


* 


*IOCP 


*IOCP 


*IOCP 


*IOCP 


*IOCP 


*IOCP 


CNTLUNIT CUNUMBR=00 ,UNIT=3811,UNITADD=((03,4)),SHARED=N, 
PATH=(00) 

IODEVICE UNIT=3211,ADDRESS=(004,3) , CUNUMBR=00 

IODEVICE UNIT=DUMMY , ADDRESS=003 , CUNUMBR=00 


CNTLUNIT CUNUMBR=02,UNIT=3203 ,UNITADD=((07,1)),SHARED=N, 
PATH=(00) 


IODEVICE UNIT=3203 ,MODEL=4 ,ADDRESS=(007) , UNITADD=07 , CUNUMBR=02 


CNTLUNIT CUNUMBR=03,UNIT=3800,UNITADD=((0C,1)),SHARED=N, 
PATH=(00) 

IODEVICE UNIT=3800,FEATURE=CGS2, 
ADDRESS=(00C,1) ,UNITADD=0C , CUNUMBR=03 


CNTLUNIT CUNUMBR=04,UNIT=3505,UNITADD=((12,4)),SHARED=N, 
PATH=(00) 

IODEVICE UNIT=3505,ADDRESS=(012,1) ,CUNUMBR=04 

IODEVICE UNIT=3525,ADDRESS=(013,1) ,CUNUMBR=04 

IODEVICE UNIT=1288,ADDRESS=(014,1) ,CUNUMBR=04 


CNTLUNIT CUNUMBR=05,UNIT=3880,UNITADD=((80,16)),SHARED=N, 
PATH=(28,2F) , PROTOCL=S 
IODEVICE UNIT=3351P,ADDRESS=(080,2) , CUNUMBR=05 , UNITADD=80 


CNTLUNIT CUNUMBR=06, UNIT=3880,UNITADD=((CO,32)),SHARED=N, 
PATH=(20,2A) , PROTOCL=S 
IODEVICE UNIT=3350P,ADDRESS=(0CO,8) , CUNUMBR=06 , UNITADD=CO 


CNTLUNIT CUNUMBR=07, UNIT=3705,UNITADD=((E0O,16),(F1,3)), 
PATH=00 , SHARED=N 

IODEVICE UNIT=2741C,ADDRESS=(0E0O,16) , CUNUMBR=07 , TCU=2703, 
ADAPTER=IBM1 ,FEATURE=AUTOANSR 

IODEVICE UNIT=3705,ADDRESS=(OF1,3) ,CUNUMBR=07,ADAPTER=CA1 
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D-1 


* 
* 
KRREEKKEKEKKEKKKKKEKREKKEKEXR UNIT ADDRESSES 100-1FF KREKEKKKKEKRKKKKKEKRKKKKKEKRKEKER | 
‘ ; ) 
CNTLUNIT CUNUMBR=10,UNIT=3880,UNITADD=( (00,32) ),SHARED=N, * 
PATH=(01,0B) , PROTOCL=S 
IODEVICE UNIT=3351P,ADDRESS=(100,2) , CUNUMBR=10, UNITADD=00 
IODEVICE UNIT=3351P,ADDRESS=(110,2) ,CUNUMBR=10,UNITADD=10 


*IOCP 
CNTLUNIT CUNUMBR=11,UNIT=3880,UNITADD=( (20,32) ),SHARED=N, * 
PATH=(06,1F) , PROTOCL=S 
CNTLUNIT CUNUMBR=16,UNIT=3880,UNITADD=( (20,32) ),SHARED=N, * 
PATH=(07,29) ,PROTOCL=S 
IODEVICE UNIT=3351P,ADDRESS=(120,4) ,CUNUMBR=(11,16) 
IODEVICE UNIT=3351P,ADDRESS=(130,4) , CUNUMBR=(11,16) 
*IOCP 


CNTLUNIT CUNUMBR=13,UNIT=3880 ,UNITADD=( (60,32) ),SHARED=N, * 
PATH=(10,1A) , PROTOCL=S 
IODEVICE UNIT=3350P,ADDRESS=(160,4) ,UNITADD=60 , CUNUMBR=13 


* 
* 
REEKKKEKKKKEKKKKKKKKEKE [TJNIT ADDRESSES 2OO-2FF FERRER EKKKKEKKEKKKKEKKKKKKK 
* 


CNTLUNIT CUNUMBR=20,UNIT=3880,UNITADD=((20,16)), * 
PATH=(13,2F) ,PROTOCL=S , SHARED=N 

CNTLUNIT CUNUMBR=21,UNIT=3880,UNITADD=((20,16)), > 
PATH=(10,25) ,PROTOCL=S , SHARED=N 

IODEVICE UNIT=3380,ADDRESS=(220,16) ,UNITADD=20, * 
CUNUMBR=(20,21) ,STADET=N , FEATURE=ALTCTRL 

*IOCP 

CNTLUNIT CUNUMBR=22,UNIT=3880,UNITADD=((70,16)), - 
PATH=(1B) , PROTOCL=S , SHARED=N 

CNTLUNIT CUNUMBR=23,UNIT=3880,UNITADD=((70,16)), = 
PATH=(25,17) , PROTOCL=S , SHARED=N ) 

IODEVICE UNIT=3380,FEATURE=(ALTCTRL,SHARED) , s ) 


ADDRESS=(270,16) , UNITADD=70 , CUNUMBR= (22,23) 


* 
* 
REEKKKKKKKKKKKKKKKKKKKE TJINIT ADDRESSES 300-3FF ¥¥RRERRKEKKEKEKEKKKKKKKKKKKEKK 
* 


CNTLUNIT CUNUMBR=30,UNIT=3274,UNITADD=((60,32)), * 
PATH=(05) , SHARED=N 
IODEVICE UNIT=3270,MODEL=x, * 


+ 


FEATURE=(EBKY3277,KB78KEY , SELPEN, DOCHAR, AUDALRM,PTREAD) , 
ADDRESS=( 360,16) , UNITADD=60 , CUNUMBR=30 
* ITOCP 
CNTLUNIT CUNUMBR=31,UNIT=3274,UNITADD=((CO,32)), * 
PATH=(OF) , SHARED=N 
IODEVICE UNIT=3270,MODEL=xX, 


FEATURE= (EBKY3277,KB78KEY , SELPEN,DOCHAR,AUDALRM) , * 
ADDRESS=(3C0,16) , UNITADD=CO , CUNUMBR=31 

IODEVICE UNIT=3270,MODEL=X, * 
FEATURE= (EBKY3277,KB78KEY , SELPEN , DOCHAR, AUDALRM) , * 
ADDRESS=(3D0,6) , UNITADD=DO , CUNUMBR=31 

IODEVICE UNIT=3286,MODEL=2, * 
FEATURE=DOCHAR, * 


ADDRESS=(3D6,2) , UNITADD=D6 , CUNUMBR=31 

IODEVICE UNIT=3270,MODEL=X, 
FEATURE= (EBKY3277,KB78KEY , SELPEN , DOCHAR, AUDALRM) , 
ADDRESS=(3D8,8) , UNITADD=D8 , CUNUMBR=31 


+ + 
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* 
* 


KakKKKKKKKKKKKKKKKKKKEKK UNIT ADDRESSES GQQ0-4FRF KER KKKKKKKKKKKKKKKKKK KK EE 


* 


*LOCP 


*IOCP 


*IOCP 


*IOCP 


* 
* 


CNTLUNIT CUNUMBR=48,UNIT=3830,UNITADD=((10,16)), 
PATH=(0A,14) , SHARED=N 


IODEVICE UNIT=3330,ADDRESS=(410,16) , FEATURE=SHARED , CUNUMBR=48 


CNTLUNIT CUNUMBR=49,UNIT=3880,UNITADD=((20,16)), 
PATH=(02) , SHARED=N , PROTOCL=S 

CNTLUNIT CUNUMBR=4A, UNIT=3880,UNITADD=((20,16)), 
PATH=(0C,16) , SHARED=N,PROTOCL=S 


IODEVICE UNIT=3380,FEATURE=(ALTCTRL,SHARED) , ADDRESS=(420,16) ,* 


CUNUMBR= (49, 4A) 


CNTLUNIT CUNUMBR=41,UNIT=3880,UNITADD=((70,16)), 
PATH=(0A,14) , SHARED=N, PROTOCL=S 

IODEVICE UNIT=3380,FEATURE=(ALTCTRL,SHARED) , 
ADDRESS=(470,16) , UNITADD=70 , CUNUMBR=41 


CNTLUNIT CUNUMBR=42,UNIT=3830,UNITADD=((A0,16)), 
PATH=(02,24) , SHARED=N 

CNTLUNIT CUNUMBR=43,UNIT=3830,UNITADD=((AO0,16)), 
PATH=(0C,16) , SHARED=N 

IODEVICE UNIT=3330,MODEL=11, 
FEATURE=(SHARED,ALTCTRL), 
ADDRESS=(4A0,16) , UNITADD=AO , CUNUMBR=(42,43) 


CNTLUNIT CUNUMBR=44,UNIT=3880,UNITADD=((E0,16)), 
PATH=(12) ,SHARED=N, PROTOCL=S 

CNTLUNIT CUNUMBR=45, UNIT=3880,UNITADD=((E0O,16)), 
PATH=(0C,28) ,SHARED=N,PROTOCL=S 

IODEVICE UNIT=3380,FEATURE=(ALTCTRL,SHARED), 
ADDRESS=(4E0,8) , UNITADD=EO , CUNUMBR=(44,45) 


KkKAKKKKKKKKKKKAKKKKKEKK UNIT ADDRESSES 5OO-SEF KERR KK KK KKKKKKKKKKKEKK KKK 


* 


*IOCP 


CNTLUNIT CUNUMBR=50,UNIT=3480,UNITADD=((60,16)), 
PATH=(0E,04) , SHARED=N, PROTOCL=S 

IODEVICE UNIT=3480,FEATURE=(SHARABLE) ,OFFLINE=YES, 
ADDRESS= (560,02) , UNITADD=60 , CUNUMBR=50 

IODEVICE UNIT=3480,OFFLINE=NO, 
ADDRESS=(562,04) , UNITADD=62 , CUNUMBR=50 

IODEVICE UNIT=3480,FEATURE=(SHARABLE) ,OFFLINE=YES, 
ADDRESS= (566,10) , UNITADD=66 , CUNUMBR=50 


CNTLUNIT CUNUMBR=52,UNIT=3803,UNITADD=((80,16)), 
PATH=(04,0E) , SHARED=Y 

IODEVICE UNIT=3420,MODEL=8,OFFLINE=YES, 
FEATURE=(9-TRACK,ALTCTRL,OPT1600), 
ADDRESS=(580,5) , UNITADD=80 , CUNUMBR=52 

IODEVICE UNIT=3420,MODEL=5,OFFLINE=YES, 
FEATURE=(9-TRACK,ALTCTRL) , 
ADDRESS=(585,1) , UNITADD=85 , CUNUMBR=52 

IODEVICE UNIT=3420,MODEL=8 ,OFFLINE=YES, 
FEATURE=(9-TRACK,ALTCTRL,OPT1600), 
ADDRESS=(586,10) , UNITADD=86 , CUNUMBR=52 
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* 
* 


REKKKKKKKKKKKKKKKKKKKK [TJNIT ADDRESSES 600-6FF K¥ERRKKKKKKKKKKKKKKKKKKKKK 
* 


CNTLUNIT CUNUMBR=60,UNIT=3830,UNITADD=((00,16)), ” 
PATH=(06) , SHARED=N 
CNTLUNIT CUNUMBR=61,UNIT=3830,UNITADD=((00,16)), im 
PATH=(13) , SHARED=N 
IODEVICE UNIT=3330,ADDRESS=(600,16) ,UNITADD=00, * 
FEATURE=(SHARED,ALTCTRL) , CUNUMBR=(60,61) 
*TOCP 
CNTLUNIT CUNUMBR=62,UNIT=3880,UNITADD=((60,16)), * 
PATH=(0A,1E) ,SHARED=N ,PROTOCL=S 
CNTLUNIT CUNUMBR=63,UNIT=3880,UNITADD=((60,16)), ee 
PATH=(14) , SHARED=N,PROTOCL=S 
IODEVICE UNIT=3380,ADDRESS=(660,16) ,UNITADD=60, * 
FEATURE=(SHARED,ALTCTRL) , CUNUMBR= (62,63) 
*IOCP 
CNTLUNIT CUNUMBR=64,UNIT=3880,UNITADD=((80,16)), . 
PATH=(0A,1E) , SHARED=N , PROTOCL=S 
CNTLUNIT CUNUMBR=65, UNIT=3880,UNITADD=((80,16)), * 
PATH=(14) , SHARED=N,PROTOCL=S 
IODEVICE UNIT=3380,ADDRESS=(680,16) ,UNITADD=80, * 


FEATURE=(SHARED,ALTCTRL) , CUNUMBR=(64,65) 
* 


* 
KKKKKKKKKKKKKRKKKEKKAKEKK UNIT ADDRESSES JTOO-7TEFF *E EKER KK KKK KEKKKEKKKKKK KEKE 
* 


CNTLUNIT CUNUMBR=74,UNIT=3880,UNITADD=((C0O,16)), * 
PATH=(OD) , PROTOCL=S , SHARED=N 

CNTLUNIT CUNUMBR=75,UNIT=3880,UNITADD=((C0O,16)), x 
PATH=(17) , PROTOCL=S , SHARED=N 

IODEVICE UNIT=3380,ADDRESS=(7C0,16) ,UNITADD=CO, * 
FEATURE=(SHARED,ALTCTRL) , CUNUMBR=(74,75) 

*IOCP 

CNTLUNIT CUNUMBR=73,UNIT=2835,UNITADD=((FO,16)), x 
PATH=(03,0D) ,SHARED=N 

IODEVICE UNIT=2305,MODEL=2, * 
ADDRESS=(7F0,1) ,UNITADD=FO , CUNUMBR=73 

IODEVICE UNIT=2305,MODEL=2.,, * 


ADDRESS=(7F8,1) ,UNITADD=F8 , CUNUMBR=73 
* 


x 
REKKKKKKKKKKKKKKKKKKKK [JNIT ADDRESSES S800-8SFF B® RRRREKKKKKKKKKKKKKKKKKE 
* 


CNTLUNIT CUNUMBR=82,UNIT=3880,UNITADD=((70,16)), z 
PATH=(21) , SHARED=N , PROTOCL=S 

CNTLUNIT CUNUMBR=83,UNIT=3880,UNITADD=((70,16)), * 
PATH=(2B,09) , SHARED=N, PROTOCL=S 

IODEVICE UNIT=3380,FEATURE=(SHARED,ALTCTRL), * 
ADDRESS=(870,8) , UNITADD=70 , CUNUMBR= (82,83) 

*ITOCP 

CNTLUNIT CUNUMBR=85 , UNIT=3880,UNITADD=((C0O,16)), : 
PATH=(21,26) , SHARED=N , PROTOCL=S 

CNTLUNIT CUNUMBR=86, UNIT=3880,UNITADD=((CO,16)), x 


PATH= (2B) ,SHARED=N, PROTOCL=S 

IODEVICE UNIT=3380,CUNUMBR=(85,86), 
FEATURE=(SHARED,ALTCTRL), ® 
ADDRESS=(8C0,8) ,UNITADD=CO, 
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* 
* 


kKaeKKKKKKKRKKKKKKKEKRKKKKK UNLT ADDRESSES S900-SFF kKakkkK KKK KRKKKRKKKRKKKRKKKEK KK 


* 


*TOCP 


* 
* 


CNTLUNIT CUNUMBR=90,UNIT=3880,UNITADD=((70,16)), 
PATH=(1D) , SHARED=N , PROTOCL=S 


IODEVICE UNIT=3380,FEATURE=SHARED , ADDRESS=(970,8) , CUNUMBR=90 


CNTLUNIT CUNUMBR=93,UNIT=3880,UNITADD=((DO,16)), 
PATH=(1D,27) , SHARED=N, PROTOCL=S 


IODEVICE UNIT=3350,FEATURE=SHARED , ADDRESS=(9D0,16) , CUNUMBR=93 


kKkKRKKKKKKKKKKKKRKREKKKEKK [TJINTT ADDRESSES AOO-AFF KRRKKKKEKEKKKRKKKEKRKKRKK KEK K* 


* 


* 
* 


CNTLUNIT CUNUMBR=A2,UNIT=3880,UNITADD=((70,16)), 
PATH=(1E,28) ,SHARED=N, PROTOCL=S 


IODEVICE UNIT=3380,FEATURE=SHARED , ADDRESS=(A70,8) , CUNUMBR=A2 


kkekekkkkKkKKRKKRKRKKRKKRKRKEKK UNIT ADDRESSES BOO-BFF KKKRKR RRR KRKRKKKRKKRKRKKKRKKRKRKRKKE* 


* 


*IOCP 


* 
* 


CNTLUNIT CUNUMBR=B2 ,UNIT=3800,UNITADD=((01,4)), 
PATH=(04) , SHARED=N 

IODEVICE UNIT=3800,MODEL=3 , FEATURE=BURSTER,CUNUMBR=B2, 
ADDRESS=(BO1,3) ,UNITADD=01, 


CNTLUNIT CUNUMBR=B3,UNIT=3811,UNITADD=((07,1)), 
PATH=(08,09) , SHARED=N 
IODEVICE UNIT=3211,CUNUMBR=B3 , ADDRESS=BO7 , UNITADD=07 


KRAREKKKKKKRKKRRKRRKKRRKKRKEK UNIT ADDRESSES COO-CFF KkRKKKKKRKRKRKKRKRKRKKRKKKEKRKRKKEK 


* 


* 
* 


CNTLUNIT CUNUMBR=C1,UNIT=CTC,UNITADD=((CO,32)),PATH=(15), 
SHARED=N 

IODEVICE UNIT=CTC,FEATURE=370, 
ADDRESS=(CCO,32) , UNITADD=CO , CUNUMBR=C1 , TIMEOUT=N 


* 


Kae KKRKRKKRKKKEKKKRKRKRKRKRKRRKEK UNIT ADDRESSES DOO-DFF KRRKEKKKKEKKRKKRKRKRKKKKRRKKK KKK K 


* 


*IOCP 


CNTLUNIT CUNUMBR=DO,UNIT=3880,UNITADD=((20,16)), 
PATH=(18) ,SHARED=N,PROTOCL=S 

CNTLUNIT CUNUMBR=D1,UNIT=3880,UNITADD=((20,16)), 
PATH=(22,2C) ,SHARED=N, PROTOCL=S 

IODEVICE UNIT=3380,CUNUMBR=(D0O,D1) ,ADDRESS=(D20,8), 
FEATURE=(SHARED,ALTCTRL) , UNITADD=20 


CNTLUNIT CUNUMBR=D2 , UNIT=3880,UNITADD=((70,16)), 
PATH=(18) , SHARED=N, PROTOCL=S 

CNTLUNIT CUNUMBR=D3,UNIT=3880,UNITADD=((70,16)), 
PATH=(22,08) ,SHARED=N, PROTOCL=S 

IODEVICE UNIT=3380,FEATURE=(SHARED,ALTCTRL) , 
ADDRESS=(D70,8) , UNITADD=70 , CUNUMBR=(D2,D3) 
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* 
* 
KRREAEKKKEKKKKRKRKKKKKKRKRKKREK UNIT ADDRESSES EOO-EFF ¥¥¥®¥®¥®RRRRKEKKKKKKKKKKKKKK 
* 





CNTLUNIT CUNUMBR=E0O, UNIT=3880,UNITADD=((20,16)), - 
PATH=(19) , SHARED=N,PROTOCL=S 

CNTLUNIT CUNUMBR=E1,UNIT=3880,UNITADD=((20,16)), - 
PATH=(23,2E) ,SHARED=N, PROTOCL=S 

IODEVICE UNIT=3380,ADDRESS=(E20,16) ,UNITADD=20, * 
FEATURE=(SHARED,ALTCTRL) , CUNUMBR=(EO,E1) 

*IOCP 

CNTLUNIT CUNUMBR=E2 , UNIT=3880,UNITADD=((70,16)), * 
PATH=(19) ,SHARED=N , PROTOCL=S 

CNTLUNIT CUNUMBR=E3,UNIT=3880,UNITADD=((70,16)), z 
PATH=(23,2D) , SHARED=N,PROTOCL=S 

IODEVICE UNIT=3380,ADDRESS=(E70,8) ,UNITADD=70, * 


FEATURE=(SHARED,ALTCTRL) , CUNUMBR=(E2,E3) 
x 


* 
* 
KKEKEKEKKEKKEKKEKKEKEKKEKKEKEKEEKREKEKRKEKREKKKEKEKKEKEKKEKRKREKKEKKEKKEKEEKKEKKKKKAKKKKKKKKKKKEK 


KkKXkkKkKkKK UNITNAMES KkKkekKkkKKEK 
KKEEKKEKKKKEEKKEKKKKEKKKKKEREKKKKKKEKKKKRKEEKKKKEKKKEKHEKK KEK KK KKK KKKEKKEKKKKKKE 
SPACE 3 

SYSRDR UNITNAME NAME=SYSRDR,UNIT=(012) 

SYSPR UNITNAME NAME=SYSPR,UNIT=(004,006,007,00C,B01,B07) 

TAPE UNITNAME NAME=TAPE, UNIT=( (580,16) ) 

DASD2305 UNITNAME NAME=DRUM,VIO=NO, * 
UNIT=(7F0O,7F8) 

DASD3350 UNITNAME NAME=DISKAA,VIO=NO, * 
UNIT=((0C0,8),(160,4) ) 

DASD3351 UNITNAME NAME=DISKBB,VIO=NO, * 


UNIT=((080,2),(100,2),(110,2)) 
DASD3380 UNITNAME NAME=DASD,VIO=NO, 
UNIT=((220,16),(270,16), 
(660,16), (680,8) ,(688,8), 
(700,16) ,(9D0,16),(A70,08), 
(D20,8) ,(D70,8), (E20,16) ) 
SYSD3380 UNITNAME NAME=SYSDA,VIO=YES, 
UNIT=((220,16),(270,16), 
(420,16) ,(470,16),(4A0,8), 
(660,16) ,(680,8) ,(688,8), 
(700,16) ,(9D0,16), (A70,08) ) 
SYSQ3380 UNITNAME NAME=SYSSQ,VIO=YES,UNIT=((220,16),(270,16), 
(7C0,16),(9D0,16) ,(A70,08), * 
(D20,8),(D70,8) ,(E20,16),(E70,8) ) 


+ *&€ & & 


+ + & 


x 
* 
KREKKKKKKEKKERKEKKKKKEKEKEKEKKEKKEKKKEKRKERKKKKKKKKKKKKKKRKKKK KKK KKK KKKKRKRKKKE 
kKkKkkKKK* NIP CONSOLES kkekkkKK* 
KEKKKKKEKEKKKKKEKEKKEKEKKEKEKKKKKKEKKEKEKEKKKEKARKKEEKKKKEKKKKKKKKAK KKK KKK KKKKKKEKSE 
* 


CONSOLES NIPCON DEVNUM=(3D1,361,3C4,3D4,3D8) 
NIPCON DEVNUM=(360,363,3D0,3C7,3C8, 3CE) 
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Appendix E. Eligible Device Table Verification Service 


The EDT verification routine, IEFEB400, verifies that an EDT constructed by 
MVSCP matches the devices defined by the UCBs in the system on which 
IEFEB400 is running. If a mismatch is found, an appropriate message is written 
to the hardcopy log and to the operator. 


Notes: 


e Do not attempt to verify an EDT that was built through the previously used 
SYSGEN process. Such an attempt will give erroneous results. 


e JIEFEB400 cannot verify individual teleprocessing units; only the device class 
is checked. 


During the IPL process, MVS invokes the EDT verification routine TEFEB400) 
to check the entries in the eligible device table currently in use against the current 
unit control blocks (UCBs). 


You can also run IEFEB400 as a batch job by submitting JCL statements. 
IEFEB400 must always be run on a system that is using the I/O configuration for 
which the new EDT was built. For an example of the JCL you will need, see 
“Sample JCL for Executing IEFEB400” on page E-3. 


EDT Verification Processing 


The processing that occurs when IEFEB400 runs during IPL is slightly different 
than the processing that occurs when it runs as a batch job. The following topics 
identify the messages, return codes, and reason codes that result from the different 
conditions that IEFEB400 detects. For additional message information, see 
MVS/XA System Messages Volume 2 IEC - ISG. 


Batch Processing Results 


e IEFEB400 always issues message IEF923I to identify the EDT that it will 
verify. 


e If EDT verification is successful, IEFEB400 issues message IEF926I. 


If an error or mismatch occurs, IEFEB400 issues one of the following messages 
and return codes. 


Appendix E. Eligible Device Table Verification Service E-1 









Action Return Code 
Message Condition Detected Taken (See note) 
a : 

































IEF9241 The device type in a UCB does not match the Verification 
corresponding EDT entry. processing 
continues 
IEF925I The EDT includes a device type for which there is no Verification 20 
matching UCB with the correct device number. processing 
continues 
IEF927]1 The EDT has not been rebuilt to run on MVS/XA. Verification 16 
processing 
stops 
IEF9291 The EDT identifier specified on the EXEC statement Verification 24 
PARM field is invalid. processing 
stops 
IEF9291 The EXEC parameter was valid but the specified EDT Verification 28 
could not be loaded. processing 
stops 


Figure E-1. I[EFEB400 Batch Results 


Note: JEFEB400 stores the return code into register 15. 


IPL Processing Results 


e JIEFEB400 always issues message IEF923I to identify the EDT that it will 
verify. 


e If EDT verification is successful, IEFEB400 issues message IEF926I. 


If an error or mismatch occurs, IEFEB400 issues one of the following messages or 
wait state codes. 


Action Wait Code/ 
Message Condition Detected Taken Reason Code 
TEF924] The device type in a UCB does not match the Verification 
corresponding EDT entry. processing 
continues 
IEF925I] The EDT includes a device type for which there is no Verification none 
matching UCB with the correct device number. processing 
continues 
IEF9271 The EDT has not been rebuilt to run on MVS/XA. 200/0001 
State 
IEF9281 There are devices defined in the EDT for which there System wait 200/0002 
are no corresponding UCBs in the I/O configuration state 
being used. 


Figure E-2. TEFEB400 IPL Results 
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Sample JCL for Executing IEFEB400 
/ /EDTVER JOB 'ACCTINFO','NAME' ,MSGLEVEL=(1,1) 
//STEP1 EXEC PGM=IEFEB400,PARM=xx 
//SYSPRINT DD SYSOUT=A 


//EDT DD DSN=SYS1.EDTLIB 
//SYSABEND DD SYSOUT=A 


Notes: 


I. In the example, the variable xx must be the identifier 
of the EDT to be verified. 


The EDT to be verified must be a PDS member. In the example, the 
DD statement named EDT identifies this PDS. 


The I/O configuration in use on the system where IEFEB400 is run 
must be the I/O configuration for which the EDT was built. 





Figure E-3. Sample JCL for Executing IEFEB400 
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